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Summary of Amendments 
I Independent Component Release of IBM 3800 Printing Subsystem Support 

I Technical Newsletter GN33-9230 documents changes to support the IBM 3800 Printing 
I Subsystem under DOS/VS. 

/ 

Technical Newsletter GN33-9226 corrects errors in the base publication and documents. 
the restoring of DOS/VS to minidisk under VM/370. 

Release 34 

Edition GC33-5377-6 documents: 

• Full support for the IBM 3350 and IBM 3330-11 

• Support of the IBM 3277 as operator console 

• Support of the IBM 3540 as IPL communication device 

• Inclusion of functions of the COPYSEBV program into the CORGZ program and 
the removal of the COPYSERV program from DOS/VS 

• Improvement of initial program load through tfye use of an IPL communication devi o 
list 

• Integration of support information on System/370 CPU Models 135-3, 138, 145-3, and 148 
and on the IBM 3203*4 printer 

• Removal of POWER/VS generation information that was provided in Module 2 of earlier 
editions of this manual; this information is now included in DOS/VS POWER/VS 
Installation Guide and Reference ,, GC33-6048 

• EREP enhancements for CPO Models 135, 138, and 158 

In addition, corrections and editorial changes have been made to improve the manucs! ' 
usability. 



Release 33 

Edition GC33-5377-5 documents: 

Installation improvements 

POWER/VS enhancements 

VSAM enhancements 

Access Method Services enhancements 

New utility programs 

Cardless system support 

Minor changes and corrections throughout the manual 

Note that Module 1, "Planning and Procedures", has been revised entirely. 



Release 32 

Edition GC33-5377-4 documents: 

• Cross-partition event control 

• CIL patch program (PDZAP) 

• Highspeed standalone dump 

• Fast CCW translation 

• Minor changes and corrections throughout the manual 



Preface 



The information in this publication is of particular interest to anyone responsible for 
the planning and/or implementation of system generation and maintenance for DOS/VS. This 
includes installation managers, system analysts, programmers, and machine operators. 

Familiarity with the following system programs and facilities is invaluable when using 
this publication: 

• Control programs (supervisor, job control,, and IPL) 

• System service programs (linkage editor and librarian) 

• Input/Output Control System (IOCS) logic modules. 

The storage estimates given in this publication are within 15% of actual requirements. 

MODULAR ORGANIZATION OF THIS MANUAL 

This publication is in a modular format that enables you to discard unwanted modules and 
to insert system generation modules from program product documents. Thus, you can easily 
prepare a system generation document for your own installation. 

Although the pages are numbered consecutively throughout the book, each module is 
self-contained. A numbered tab on the right-hand edge of the page indicates the 
beginning of each new module. If module volume warrants, a Module Outline and 
Module Index is provided. 

The total publication has a General Contents and a General Index . These refer you to 
the individual module numbers. Figure numbers throughout the publication are in the 
form: Figure 1-3, where 1 is the module number and 3 is the figure number within the 
module. 

Each module in this publication is a collection of information about a particular 
component or related topics- The modules, numbered from 1 to 25, are grouped as follows: 

Module 1: Planning and procedures information 

Module 2: POWER/VS 

Module 3: Installation Verification Procedures (IVP) 

Modules 4-6: Emulator Programs 

Modules 7-16: I/O Components 



Module 17 
Module 18 
Module 19 
Module 20 
Module 21 
Module 22 
Module 23 
Module 21 
Module 2 5 



VSAM 

Assembler 

System aids (OLTEP) 

BTAM 

QTAM 

VTAM 

SSS 

System Utilities 

EREP 



Prerequisites for a thorough understanding and effective use of this publication are: 

D OS/VS System Management Guide , GC33-5371 

DOS/VS System Control Statements , GC33-5376 

DOS/VS Supervisor and I/O Macros , GC33-5373 

DOS/VS Operating Procedures , GC33-5378 

DOS/VS Messages , GC33-5379 

DOS/VS System Utilities , GC33-5381 

iLfi Sv^ut-ii!/37C SUDsyst^w Support Services User's Guide , GC30-302?. 

Guiue to thfe DOS/VS As^rnblfcr , GP33-4024 

i'jcviiK ire hi »cdel 20 to DCS/VS , GC33-5336 
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modules, number of -jq6 

phases, number of -jq 6 

copy disk to card 

core image library blocks. 1Q6 

modules, number of -]Q6 

phases, number of...... 106 
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copy disk to disk 

core image library blocks 1C6 

nodules, number of..., 106 

phases, number of. 106 

copy file and maintain object 
module (OBJMAINT) utility 

core image library blocks 106 

modules, number of....... 10t> 

phases, number of 106 

copy selectively to merye libraries 
(Ste COhGV) 

core image library. 

components. 103 

CORGZ , . 104 

CSERV 10 4 

directory capacities 75,85 

DSERV. 104,119 

DUMPGEN 105, 131 

EREP 103 

ESERV 103 

IBM-supplied 25 

IPL and buffer load 104,115 

job control 104,118 

linkage editor 104,118 

MAI NT 104,118.1 

MCAR/CCH 10 5, 123 

PDAID 105,131 

PDSDM 105, 132 

PSEHV 104,119 

RSERV 104,119 

SSERV 104, 119 

standard system dump 103,129 

supervisor macros 105 

supervisor nucleus 120 

translating system dump 10 3,129 

CORGZ 

core image library blocks 118.1 

examples of use 80,90,91 

link-edit statements 118.1 

modules names • 118.1 

modules, number of 104 

phase names 118.1 

phases, number of 104 

creating system files. 75 

page data set 75 

recorder file 76 

hard-copy file 77 

cross-partition event control 45 

CSERV 

core image library blocks 104 

link-edit statements 119 

module names 119 

modules, number of 104 

phase names 119 

phases, number of •• 104 

CYL. . , 57 

cylinder capacity, system library 75 



D2311 5 1 

D2314 51 

D2321 51 

D2400 * 51 

D3330 51 



D3340 51 

D3350 51 

D3410 » 51 

D3420 51 

D3540 51 

I D3 800 51 ,68 

D3886 51 

DASDFP. . 39 

data cell to tape 

core image library blocks 106 

modules, number of ..... .. 106 

phases, number of........... 106 

DATE 37 

DEC 37 

DECK 37 

declaring SYSRES libraries as 

private libraries.. 90,97 

define labels 89,101 

define the page data set (DPD) 57 

delete procedure.. 86 

delete unwanted library entries. 92 

device address specification 56 

dtvice codes for EVCGEN 60 

DIMOD 

storage requirements. .............. .. 111 

directory capacities, system 75,85 

DISK 46 

disk initialization 81,85 

disk initialization bypass 82 

disk to card 

core image library blocks.. 106 

modules, number of 106 

phases, number of . 106 

disk to disk 

core image library blocks............ 106 

modules, number of 106 

phases, number of.. 106 

disk ERP 103,130 

core image library blocks 103 

disk to tape 

core image library blocks 106 

modules, number of........ 106 

phases, number of 106 

display operator console (DOC) 39 

distribution tape processing 

without an operational DOS/VS. 81 

display operator console.. 103,130 

core image library blocks 103 

modules, number of.... 103 

phases, number of 103 

relocatable library blocks 103 

source statement library blocks...... 103 

display the source of supervisors... 97,122 

DOC 39 

DOS/VS component sizes and library 

requirements 103 

DPD macro 57 

DSERV 

core image library blocks..... 104 

link-edit statements 119 

modul e names 119 

modules, number of 104 

phase names 119 

phases, number of....... 104 

DTFCD (define the file card) , size 

of table 110 

DTFCN (define the file console)........ 112 
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DTFDI (define the file device 
independent system units) 111 

DTFPH (define the file physical 
IOCS), size of table 112 

DTFPR (define the file printer), 
size of table 111 

DTFSR (define the file serial 
device), size of table.., 112 

DUMP 37 

DUMPGEN 

core image library blocks 105 

link-edit statements 131 

modules 131 

modules, number of 105 

phases . 121 

phases, number of 105 

relocatable library blocks 105 

dumps 

page data set... 105,132 

standard system dump 129 

translating system dump 129 

DVCGEN macro 53 

DVCTYP 53 

E 

ECPREAL 39 

EDECK 37 

emulator generation 25 

end of supervisor macro, SEND 57 

environmental recording, editing, 

and printing program (see EREP) 
EREP 

core image library blocks 103 

modules, number of 103 

phases, number of 103 

ERRLOG 34 

error recovery procedures 

disk (DKE) 130 

tape (TPE) 131 

error statistics 

by tape volume..... 44 

2495 tape cartridge reader 43 

ERRQ 39 

ERRS 37 

ESERV 

core image library blocks 103 

modules, number of 103 

phases, number of ; 103 

relocatable library blocks 103 

EU 34 

EVA 39 

example for system generation........... 93 

EXIT 45 

F 

failure in generating a .system 102 

fast CCW translation 40 

fast copy disk volume utility 
(FASTCOPY) 

core image library block 106 

examples of use 80,90,102 

modules, number of 106 

phases, number of............ 106 

source statement library blocks 106 



source statement library books 106 

FASTTR 40 

FETCH performance 27,40 

FOPT macro 38 

forced macros 59 

FP 36 

FnPGh 52 

Fn 49 

FnR 50 

G 

GETVIS 40 

GETVIS area in SVA 48 

| GRFIxxxx phases 117 

H 

hard- copy file 77, 10 

highspeed standalone dump 132 

H1STLIST 91 

HIST macro description (see the 
section "System Utilities") 

I 

I/O configuration, SYSGEN examples °3 

IBM-supplied 

core image library.... • 25 

procedure library 25 

relocatable library 25 

source statement library 25 

supervisors 26,120 

IBM DOS/VS distribution for DASD 

and tape users 77 

ID. 34 

IDRA 40 

I IEBIMAGE {utility for 3800) 117 

initialize and restore programs 

bypass initialize disk 82 

initialize disk..... 82 

restore IBM tape to disk 81,85,95 

initialize data cell 

core image library blocks. 106 

phases, number of.......... 106 

initialize disk 

core image library blocks..... 106 

phases, number of 106 

initialize tape 

core image library blocks..... 106 

phases , number of 106 

IOCS 

core image library blocks 104 

IOCS macros 108 

IOCS modules assembly listing 99 

IOCS modules cataloging 100 

IOCS modules required by compilers... 89,99 

IODEV 52 

IOTAB macro 51 

IPL and buffer load (1403U, 3203, 
3211, and 5203 printers) 

core image library blocks 104 

link-edit statements 115 

module names 115 

modules, number of 104 

phase names 115 
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phases, number of 104 

IT 4 

IVP assembly example 102 



JA 40 

JALIOCS 41 

JIB 4 52 

job accounting interface 40 

job control 

core image library blocks 104 

link-edit statements 118 

modul e names 1 1 8 

modules, number of 104 

phase names 118 

phases, number of 104 

L 

labels 8 9,101 

librarian programs 118.1 

libraries 

avoiding loss of . 90,98 

directory capacities of 75,85 

maintenance of 78,89 

not restored 85 

on SYSRES file 77 

size calculation and allocation 

for 72,85,92 

status i nf ormation of 90 

system . 25 

track capacities of.. 75 

libraries on SYSRES file 77 

library maintenance 78,80,89 

adding unique entries . 92 

creating a third library 92 

deleting unwanted entries 92 

merging an entire library 9z 

merging entries into existing 

libraries 92 

merging two libraries ^2 

programs 80 

replacing identical entries 92 

library requirements 103 

LINES 37 

linkage editor 

core image library blocks 104 

link-edit statements 118 

module names 118 

modules, number of 104 

phase names 118 

phases, number of 118 

work files.., 104 

link-edit procedure 86 

LIST 37 

listings 28 

list system history (HIS1LIST) utility 

program 91 

LISTX 37 

loading the SDL 112 

loading the SVA 48,112 

loading VSAM phases 49 

LOAD performance - 27,40 

LOG 38 

logical units, maximum per 
partition 51 



LSERV 

core image library blocks 105 

link-edit statements 13^ 

module names 1 o 2 

modules, number of 105 

phase names 1-3/ 

phases, number of... 10b 

relocatable library blocks 105 

M 

machine requirements for cardless 
systems.. 30 

machine requirements, minimum 31 

macros lor generating a supervisor 33 

macros, IBM-supplied 

ALLOC 49, 122 

ALLOCR 50, 122 

ASSGN 55,122 

BDYBOX M2 

CCB 108 

CDMOD 109 

CHECK 109 

CHKPT 130 

CLCSE 109 

CLOSER 109 

CNTRL 109 

CONFG 3 6,122 

CRTAEX 130 

CRTAWT 130 

CRTGEN 1^3,130 

CRTIO 130 

CRTSAV 123, 13C 

DIMOD 10 6,111 

DISP 1^:2 

DPD 57,122 

DTFBG 108 

DTFCD 108,110 

DTFCN 108,112 

DTFDI 10 8,111 

DTFEN 108 

DTFPH 108,112 

DTFPR 10 8,111 

DTFPT 1 C8 

DTFSR 108 

DVCGEN 53, 122 

ERET 1 C6 

EXCP 108 

FEOV . 108 

FEOVD 108 

FCPT 38,122 

FREE 1 C8 

GET 108 

IJLQDSCT 123 

IJLCTSVC 1 z3 

IOINTER 122 

IOTAB 51,122 

ISTAVT 122 

LBRET 108 

MAPCOMR 1^2 

MAPERPIB 122 

MAPLOWC 122 

MAPPUB2 122 

MCRAS 122 

NOTE >08 

OPEN 108 

OPENR 108 

PIOCS 46, 122 
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POINTR.. . . 108 

POINTS 10 8 

POINTW 108 

PRMCD 111 

PRTOV 108 

PUT 108 

PUTR 130 

I QSETPRT 117 

READ 108 

RELEASE 108 

RELSE 108 

SECTVAL 10 8 

SEND 57,122 

SEOV 108 

I SETPRT 117 

SGAM , 122 

SGCCWT 122 

SGDFCH . 122 

SGDSK 122,130 

SGEND 122 

SGPMAIN 122 

SGPOPT 122 

SGPSUB 122 

SGSCVRT 122 

SGSVC 122 

SGSVCX 122 

SGTHAP . 122 

SMICR 122 

I SPLIST 117 

STDJC 37,122 

SUPVR 33,122 

SYSIO 122 

TRUNC 108 

TTIMER 108 

VSTAB 47,122 

WAITF 108 

WRITE . 108 

macros required and forced*... . ... . . 59 

main page pool size. 50 

MAINT 

core image library blocks..... 104 

link-edit statements 119 

module names. 118.1 

modules, number of 104 

phase names... 118.1 

phases, number of 104 

maintain system history (PTFHIST) 

core image library blocks*... • 106 

examples of use ...102,106 

linking 102 

macro description Csee the 
section "System Utilities*) 

modules, number of • 106 

phases, number of 106 

source statement library blocks...... 106 

source statement library books....... 106 

utilization 91 

maintenance of libraries 89,92 

maps 28 

MCAR/CCH 123 

core image library blocks... •• 105 

MCH 34 

MERGE function (see library 
maintenance) 

merge library entries 92 

merge two libraries. • 92 

merge user programs 9 9 

MICR 35 



minimum machine requirements 30 

MNOTEs during supervisor assembly 32 

MODE 5U 

MODEL 36 

Imodelnumber suffix for CPU 36 

MRSLCH 4 6 

multitasking (AP) • 3 3 

N 

NPARTS 35 

NRES 52 

O 

OC 41 

OLTEP 41 

core image library blocks..... 105 

modules, number of 105 

phases, number of 105 

relocatable library blocks 105 

operational DOS/VS not available 81 

operational pack 

organization 71 

planning 26, 71 

operator-initiated communication 
(OC) 41 

organization of the system pack 72 

P 

page data set, define the 75 

page data set dump 

core image library blocks 105 

link-edit statements 132 

module name 132 

modules, number of 105 

phase names 132 

phases, number of 105 

page data set IPLing 101 

PAGEIN 35 

page pool, main 50 

parameters for 

ALLOC a 9 

ALLOCR 50 

ASSGN 55 

CONFG 36 

DPD . 57 

DVCGEN 53 

FOPT 38 

IOTAB 51 

PIOCS 46 

SEND 57 

STDJC 37 

SUPVR 33 

VSTAB 47 

partition save areas. 49 

PC 41 

PCIL 41 

PD 41 

PDAID 

core image library blocks 105 

phases 131 

phases, number of 105 

relocatable library blocks 105 

transients 131 

transients, number of 131 

PDZAP 132 

performance of FETCH and LOAD 27,40 
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PFIX 41 

PHO 35 

physical transient overlap 45 

PIOCS macro. 46 

planning 

POWER/VS 25 

libraries (operational pack) 26,71 

supervisor 25 

system generation 25 

the emulators 25 

the page data set 2 5 

POWER parameter in SUPVE 35 

POWER/VS 

computing the size of a supervisor, 

example , 70 

core image library blocks 105 

installation, documentation for 94 

macros 123 

POWER parameter in SUPVR macro 35 

relocatable library blocks 105 

required and forced options with 

POWER = YES. .., 59 

source statement litrary blocks 105 

supervisor real storage requirements.. 63 
with RJE,SNA 33,51 

printer support, 
1403U/3203/3211/5203 (see IPL and 
buffer load) 

Printing Subsystem (3800) 

coding for // ASSGN 83 

device code for DVCGEN macro 61 

Dxxxx parameter for IOTAB macro 51 

SETPRT and QSETPRT macro 117 

support 117 

PRINTLOG Utility 130 

private libraries 85,90,97 

private second level directories 42 

PRMOD (printer module) ...... 111 

problem determination, 

IBM-supplied list for DOS/VS 26 

procedure lihrary... ............ 2 5 

procedures 

bypass initialize disk 82 

delete 86 

initialize disk . 81 Q5 

link-edit 86 

load the SVA 26 112 

processing the distribution tape... q\ 95 
restore distribution tape to ' 

disk 81,85,96 

system generation... 78 

processing the distribution tape 81,95 

programs for system generation and 
maintenance, examples of use 

backup 80,90,98 

CORGZ 80,90,99 

DSERV . 80,102 

FASTCOPY 8 0,90,102 

maintain system history 

(PTFHIST) 1 02, 1 06 

restore 80. 90, 96 

PRTY 42 

PSERV 

core image library blocks 104 

link-edit statements. 119 

module names................... 119 

modules, number of.. 10 4 



PSLD HZ 

PTFHIST program, utilization of 1,102 

PTO... 45 

Q 

QSETPRT macro 117 

QTAM 

core image library blocks..... 105 

modules, number of 105 

relocatable library blocks 1C5 

source statement library blocks ....... 1 C 5 

R 

RDE (ERRLOG) J 4 

real address area, size of . 4 7 

real storage allocation for 

partitions. 50 

recorder file.. 7b 

reliability data extractor (RDE) 3 4 

RELLDR 4z 

relocatable library, IBM-supplied ^5 

relocatable library 

1403U printer buffer load 115 

3203 printer buffer load 115 

3211 printer buffer load 11b 

5203 printer buffer load 116 

common librarian modules 118.1 

CORGZ 104,118.1 

CSERV 104, 119 

DSERV 104,119 

DUMPGEN 105, 131 

ESERV 1 03 

EREP 103 

IPL 104, 115 

job control 10 4,118 

linkage editor 10 4,118 

LSERV 10 5,132 

MAINT 104,118.1 

PSERV 104,115 

RSEPV 10 4,119 

SSERV 10 4,119 

standard system dump 103,129 

translating system dump 10 3,129 

relocating load support 4 2,79 

replace identical library entries 9 2 

required macros 5 s 

restore card to disk 

core image library blocks 10 6 

modules, number of 106 

phases, number of 106 

restore failure , 85 

restore system tape to disk 81,85,95 

restore tape to disk or data cell 

core image library blocks 106 

modules, number of 106 

phases, number of 106 

restore utility 

core image library blocks.. 106 

examples of use 80,90,96 

modules, number of 106 

phases, number of... 106 

results of system generation 93 

RETAIN 4 2 

RMS 35 

RPS 42 
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RPS considerations 113 

deletion of RPS support 113 

preloading modules in the SVA 114 

RSERV 

core image library blocks 104 

link-edit statements 119 

modul e names •• 119 

modules , number of 104 

phase names 119 

phases, number of 10 4 

RSIZE 47 

rules 

ASSGN 56 

DVCGEN 53 

supervisor qeneration macros.......... 33 

RUTAU . . . . «+t> 

S 

SDAID 

transients 131 

link-edit statements 132 

module names - 132 

modules, number of 105 

phase names.......................... 131 

SDL (system directory list)... 27 

SDL considerations. 112 

search order for phases 27 

second level directory..... - 4.3 

BELCH 46 

selection of IBM- supplied 

supervisors 25,32,98 

BEND macro.. - 57 

BET SDL 27 

SETIME - 40 

SETPRT macro 117 

shared virtual area (SVA)..... 47 

size calculation for libraries 73 

size of main page pool 50 

size of supervisors. .................... 120 

SKSEP 43 

SLD •• 43 

source statement library.... 25 

source statement library macros 

components of. 103 

supervisor generation................ 122 

system generation. - -. 33-59 

source statement library, 

IBM-supplied 25 

SP 37 

SPARM 38 

specifications for the 3330, 3333, 

3340, 3344, 3350 31 

specifications for the 3800 *1,69 

SSERV 

core image library blocks............ 104 

link-edit statements...... 119 

module names ......................... 119 

modules, number of............ 104 

phase names.. .................. ...... 119 

phases, number of......... • 104 

SSLNS 53 

Btandard label option 89,101 

standard system dump 

core image library blocks............ 103 

link-edit statements 129 

module names.* .... 129 

modules, number of.... 103 



phase names.. -J29 

phases, number of............. 103 

status information on system 

libraries.. go 

STDJC macro „ ## 37 

storage requirements for 

IBM-supplied DOS/VS programs 72 

STXIT 40,115 

suffix for CPU model specification 36 

supervisor 

assemble 97 

catalog 32, 98 

compile 122 

computing the size of 70 

contents change . .. 122 

core image library blocks 

(IBM-supplied) 103 

device code 60 

display . 98, 122 

example for computing the size 

of 71 

generation macros (basic).. 122 

identification 44 

macro documentation. 71,91 

phase name 120 

phases, number of.... 105 

real storage requirements 62 

selection 26,32,98 

supervisor nucleus 120 

supervisors, pre- compiled 26,120 

supervisor selection 26,32,98 

supervisor shipped by IBM 120 

suppressing the relocating loader 

function 42,79 

SUPVR 33 

SVA loading 112 

SVA load procedures 26,112 

SVA (shared virtual area) 4 7 

SYM 38 

symbolic device name assignment ,.. 56 

symbolic programmer units, maximum... 51,56 

SYNCH 43 

synchronous exit 43 

SYSFIL 43 

SYSnnn , 56 

SYSRES file 77 

system component sizes, DCS/VS, 102 

system configuration. 30 

system directory and library track 

capacities 75 

system directory list loading ...112 

system directory list (SDL) • 25 

system distribution 

disk users •• 77 

tape users 77 

system generation 78 

considerations • 89 

example, 93 

programs 80 

results 93 

Unsuccessful 102 

system generation and maintenance 

procedure • 78 

system libraries 25 

system libraries 

directory capacities 75 

track capacities... 75 

system updates, history of. 91,102 
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system utility programs 

core image library blocks 106 

modules, number of.- 106 

phases, number of....-..--.- 106 



table requirements 

DTFCD 110 

DTfCN 112 

DTFDI 111 

DTFPH 112 

DTFPR 111 

DTFSR . . . . , 112 

TAPE 46 

tape to data cell 

core image library blocks. .......... . 106 

modules, number of , 106 

phases, number of..... 106 

tape to disk 

core image library blocks....* 106 

modules, number of.... 106 

phases, number of....... 106 

tape ERP 131 

core image library blocks..... 105 

link-edit statements 131 

module names. - 131 

modules, number of.... 105 

phase names.... 131 

phases, number of. 105 

task timer support 44 

TEB (2495 error statistics) 43 

TEBV (tape error statistics by 
volume) 44 

teleprocessing (see BTAM, QTAM, 
and VTAM) 

time-of-day (TOD) clock support. * 44 



TOD. 



44 



TOLTEP (see VTAM) 

TP 36 

track capacity of system library 75 , 85 

transients, IBM-supplied 

$$A$SUP1 124 

$$ ABERAA. • 124 

$ $ ABERAB 124 

$$ABERAC. 124 

$$ABERAD 124 

$$ABERAE 124 

$$ABERAF 124 

$$ABERAG 124 

$$ABERAH 124 

$$ABERAI 124 

$$ ABERAN 124 

$ SABER AO. 124 

$$ABERAP 124 

SSABERAQ 124 

$ SABER AR 124 

$$ABERA1 124 

$$ABERA2 124 

$$ABERA3 , 124 

$$ABERA4 124 

$$ABERA5 124 

$$ABERA6 124 

$$ABERA7 124 

$$ABERBA 124 

$$ABERBC 124 

$$ABERBD . . . . * 124 



$$ ABERP1 124 

$$AEERP2 124 

$$ABERP 3 124 

$$AEERP4 124 

$$AEERP5 124 

$$ABERP6 , 124 

$$ABERP7 124 

$$ABERP8 124 

$$ABERP9 124 

$$ABERRA 124 

$$AEERRB 124 

$$ABERRC 1^4 

$$AEERRD 124 

$$ABERRE 124 

$$AEERRF 124 

$$ABERRG 124 

$$AEERRH 124 

$$ABERRI 12 4 

$$AEERRJ 124 

$$ABERRK 124 

$$AEERRL 124 

$$ABERRM 124 

$$AEERRN 124 

$$ABERRO 124 

$$AEERRP 124 

$$ABERRQ 1 24 

$$AEERRR 124 

$$ABERRS 124 

$$AEERRT 124 

$$ABERRU 124 

$$ABERRV 124 

$$ABERRW 124 

$$ABERRX 124 

$$ABERRV 124 

$$AEERRZ 124 

$$ABERR1 124 

$$ABERR2 1 24 

$$AEERR3 124 

$$ABERR4 124 

$$AEERR5 124 

$$ABERR7 124 

$$AEERZ1 124 

SSABERZ2 124 

$$BATTF0 124 

$$EATTF1 124 

$$BATTF2 124 

$$BATTF3 124 

$$BATTF4 124 

$$BATTF5 124 

$$BATTNA 125 

$$BATTNB 125 

$i$EATTNC 125 

$$BATTND 125 

$$BATTNE 125 

$$BATTNF 125 

$$BATTNG 125 

$$BATTNH 125 

$$BATTNQ - 125 

$$BATTNR 125 

$$BATTNS f 125 

$$BATTNT 125 

$$BATTNU 125 

$$BATTNV 125 

$$ BATTNW 125 

$$BATTNX 125 

$$BATTNY •••- 125 

$$BATTNZ 125 

$$BATTN2 125 
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$$BATTN3 125 

$$BATTN5 125 

$$BATTN8 125 

$$BATTN9 125 

$ $ BATTU1 125 

$$BATTU2 125 

$$BCCPT1 125 

$$BCE0V1 125 

$ $ BCHKPD 125 

$$BCHKPE 125 

$$BCHKPF 125 

$$BCHKPG 125 

$$BCHKPT 125 

$$BCHKP2. 125 

$$BCHKP3 125 

$$BCHK3G 125 

$$BCIS0A U5 

$ $ BCLOSE 125 

$$BCLOSP 125 

$$ BCL032 125 

$$BCLOS3 125 

SSBCLOS4 125 

$$BCLRPS 125 

$$BCMT01 1^5 

$$BCMT02 1^5 

$$BCMT03 125 

$$BCMT04 125 

$$BCMT05 125 

$$BCMT06 125 

$$BCMT07 125 

$$BCMT08 125 

$$EDMPBC. 125 

$$BDMPDC 125 

$$BDMPPD 125 

$$BDMPPT 125 

$$BDMPVA 125 

$$BDRSTR « 125 

$$BDUMP 125 

$$BDUMPB.,. 125 

$$BDUMPD 125 

$$BENDFI 125 

$$BENDFL 125 

$$BEOJ 1^5 

$$BEOJl 125 

$$BE0J2 125 

$$BEOJ2A 1^5 

$$BE0J3 125 

$$BE0J3A 125 

$$BEOJU 1 ^5 

$$BEOJ5 125 

$$BEOJ7 126 

$$BERRTN 126 

$$EFCB . , 126 

$$BFCB00 126 

$$BFCB3 126 

$$BFCB5 126 

$$BILSVC 126 

$$EIi^iDEX 1 26 

$$BJCOPT 126 

$$EJC0P1 12 6 

$$BJDUMP 126 

$$BLSTIO. 126 

$$ELVTOC 1 26 

$$BMSGWR 126 

$$BMSGW1 126 

$$BMVKE¥ 126 

$$E0CPM1 126 

$$BOCPM2 126 

$$BCCPRP 126 



$$BOCPTl 126 

$$ECCPT2 . 1 ^6 

$$B0CPT3 126 

$$B0CPT4 1 26 

$$BCCP01 126 

$$BOCP02 126 

$$ECCP03 126 

$$BOCPll 126 

$$ECCP12 1 26 

$$BOCRTA 126 

$$EOCPTB 126 

$$BOCRTC 126 

$$BOCRTD 126 

$$BOCF E. 126 

$$BOCRTF 126 

$$EOCRTG 1 26 

$$BOCRTH 126 

$$EOCRTK 126 

$$BOCRTL 126 

$$EOCRTM 126 

$$BOCRTN 126 

$$BOCRTO 126 

$$BOCRTP 126 

$$BOCRTQ 126 

$$BOCRTR 126 

$ $ BOCRTS „ 126 

$$BOCRTT 126 

$ $ BOCRTU 126 

$$BOCRTV 126 

$$BOCRTW 1^6 

$$BOCRTX 126 

$$BOCRTY 126 

$$BOCRTZ 126 

$$BOCRTl 126 

$$BOCRT2 126 

$$BOCRT3 126 

$$BOCRT4 126 

$$BOCRT5 126 

$ $ BOCRT6 126 

$$BODACL , 126 

SSBCJJAIM 126 

$$BODAIN 126 

$$BODAIl 126 

$$BODAOl 127 

$ $ BODA02 127 

$ $ BODA03 » 127 

$$BODAO*» 127 

$$BODARP 127 

$$BODARS 127 

$$BODAUl 127 

$$BODIOl 127 

$$BODI02 127 

$$BODI03 127 

$$BODI04 127 

$$BODI05 127 

$$BODI06 127 

$$BODI07 127 

$$BODI08 127 

$$BODMSG 127 

$^BODMS2 127 

$ $ BODQ UE 127 

$$BODSMO 127 

$$BODSMW 127 

$$BODSPO» 127 

$$BODSPV 127 

$$ BODSPW 127 

$ $BODUCP 127 

$$BOFLPT.... 127 

$$BOISRP 127 
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$$BOIS0I 12 7 

$$BOIS02 127 

$$BOIS03 . ... 127 

$$BOIS0<* 127 

$$BOIS05 127 

$$BOIS06 127 

$$EOIS07 „ 127 

$$BOIS08 127 

$$BOIS09 ,... 127 

$$BOIS10 127 

$$B0IS11 1 27 

$$BOMRCE 127 

$$B0MSG1 127 

$$B0MSG2 127 

$$B0MSG3 , 127 

$$B0MSG4 127 

$$B0MSG5 127 

$&B0MSG6 127 

$$B0MSG7 127 

$$B0MSG8 127 

$$BOMT0M 127 

$$BOMT0fc 127 

$$BOMT01 127 

$$BOM102 127 

$$BOMT03 127 

$$BOMT04 127 

$$BCMT05 127 

$$BOMT06 127 

$$BOMT07 1 27 

$$BONVOL 1 27 

$$BOPEN 1 27 

$$BOPENC 1 27 

$$BOPEND 127 

$$BOPENR 127 

$$BOPENS 1 27 

$$BOPEN0 1 27 

$$B0PEN1 1 27 

$$B0PEN2 1 27 

$$B0PEN3 1 27 

$$BCPENU 1 27 

$$BOPIGN 1 27 

$$BOPNLB 1 27 

$$B0PNR2 1 27 

$$B0PNF3 1 27 

| $$B0PR3 127 

3$B0RTV1 1 27 

$$BORTV2 1 28 

$$B0SDB1 128 

$$BCSDC1 128 

$$BOSDC2 128 

$$B0SDC3 128 

$$BOSDEV 128 

$$B0SDI1 128 

$$B0SDI2 128 

$$B0SDI3 128 

$$BOSDI4 128 

$$B0SDI5 128 

$$BOSDOl 128 

$ $ B0SDG2 128 

$$BOSD03 128 

$$B0SD0U 128 

$$B0SD05. 128 

$$B0SD06 128 

$$BOSD07 128 

$$BOSDOS 128 

$$BOSD09 128 

$$BOSDRP 128 

iSBOSDBK 128 



$$BOSDRS 

$$B0SDW1 

$$BOSDW2 

$$B0SDW3 

$$BOSD00 

$$BOSD01 

$$BOSD02 

$$BOSD03 

$$BOSIGN 

$$BOUR01 

$$BOVDMP 

$$BOWDMP 

$$B02321 

$$BPCHK 

I $ $BPCLOS 

$$BPDAID. 

$$BPDMPC 

S$BPDUMP 

$$BPDMPC 

$$BPSW 

$$BRELSE 

$$BRMSG1 

$$BRMSG2 

$$BRSTRB 

$$BRSTRT 

$$BRSTR2 

$$BRSTR3 

$$BRSTRU 

$$BSDRUP 

$$BSETFF 

$$BSETFG 

$$BSETFH 

$$BSETFI 

$$BSETFL 

$$BSETL 

$$BSETL1 

$$BSETL2 

$$BSYSWR 

$$BTERM 

$$BUCB00 

$$BUCB 

$$BUCB3 

$$BUCB5 

$$BUFLDR 

$$BUFLD1 

$$BUFLD2 

$$BVSDMP 

$$B3540I 

$$B3540O 

$$B35400 

$$RAST00 

$$RAST01 

$$RAST02 

$$RAST03 

$$RAST0U 

$$RAST05 

$$RAS106 

$$RAST07 

$$RAST08 

$$RAST09 

$$RAST10 

$$RASTX1 

$$RAS112 

$$RAST13 

$$VOPENT 

transients, required - 124- 
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translating system dump 

core image library blocks 103 

link-edit statements 129 

modules* number of 129 

phase names 129 

phases, number of 103 

TRKHLD 4« 

TSWTCH 46 

TTIME 44 

TTIMER 45 



U 



UNIT 

USERID 

utilities* system (see system 
utility programs) 



57 
44 



virtual address area • 47 

virtual partition save areas 49 

virtual storage access method 

/VSAM) support 45 

VOLID 57 

volume serial number* .*••••••* • . . 89 

VSAM 45 

core image library blocks/phases 106 

macros, number of 106 

modules, number of.... 106 

phases, number of • 106 

relocatable library blocks >• 106 

source statement library blocks. ..... 106 

transients, number of...... 106 

VSAMSVA 26 

VSIZE. . 47 

VSTAB macro 47 



VTAM 

core image library blocks 106 

macros, number of - 106 

modules, number of 106 

phases, number of 106 

relocatabl e 1 ibrary blocks 106 

source statement library blocks 106 

VTOC display 

core image library blocks , ... 106 

modules, number of 106 

phases, number of.. 106 

transients, number of 106 

W 

WAITM 45 

work files 

assembler us 

linkage editor 1 1 8 

X 

XECB 45 

XREF 38 

XTBIxxxx phases 117 



Z 
ZONE. 



45 
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Introduction 



The object of DOS/VS system generation is to tailor the IBM-supplied system to tne 
requirements of your installation. This tailoring process is accomplished by: 

1. Planning system generation 

2. Implementing the plan by performing a system generation 

3. Testing the results by running the applicable IVP (Installation Verification 
Procedure) and sample problems. 

Detailed planning is essential to efficient system generation. It minimizes the need to 
modify the system after it is generated. You may want to contact your IBM marketing 
representative to set up a system generation planning meeting. IBM field engineering 
would also attend the meeting to discuss the procedure to install the SCP (Systems 
Control Programming). Planning a system includes: 

• Evaluating which of the IBM-supplied supervisors most closely meets your 
installation's requirements. Considering modifications, such as deleting components 
from, or adding options to the selected supervisor (s) . Estimating the size of the 
planned supervisor and assessing tne effects of some of the major options, such as 
multiprogramming and POWER/VS,, on the operation of your system. 

• Tailoring the supervisor to the needs of your installation, which includes planning 
the options and estimating the size of the supervisor. This entails assessing the 
implications and effects of some of the major supervisor options, such as 
multiprogramming and POWER/VS., on the operation of yc*ur system. 

• Planning the contents, organization, and size of the system and private libraries. 

• Generating POWER/VS (optional). 

• Planning the Page Data set. 

• Emulator generation (optional) . 

These major planning considerations are described in detail in the DOS/VS System 
Management Guide .. 

IBM supplies DOS/VS on either magnetic tape or on disk. These distributions are 
discussed under "Distribution of DOS/VS". 

DOS/VS is shipped in four libraries: 

The source statement library contains macro definitions in edited format. After the 
desired parameters have been chosen, the macros can be assembled. Any A- library macros 
carried over from previous releases must be edited before they can be used for assembly. 

The relocatable library contains IBM programs that have not been assigned addresses 
for execution and assembled macros from the source statement library. These assembled 
macros perform input and output procedures for IBM-supplied programs. They constitute 
Logical IOCS modules that can also be used by problem programs, whenever applicable. 

The core image library contains programs that are ready for execution. System control 
programs and system service programs are always shipped in the core image library. An 
assembler program is also provided for system generation and maintenance. The system 
control programs must always be part of the system. The librarian programs are a key set 
to the system and should be carefully considered before ever removing them from the 
system. 
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The procedure library is designed to contain frequently used sets of job control and 
linkage editor control statements, as well as control statements for IBM-supplied service 
programs. The procedure library as it is shipped on the distribution medium contains the 
SVA load procedures SDL, EPS, VSAMSV.A, and VSAMBPS. The purpose and contents of SDL and 
EPS are discussed under "SDL Considerations" and "EPS Considerations", respectively; for 
the purpose and contents of VSAMSVA and VSAMEPS, refer to "Module 17: VSAM". The 
procedure library also contains procedures for linking and deleting DOS/VS components. 

During system generation, you work with the IBM- supplied system, tailoring it to your 
individual needs by adding to and deleting from the IBM-supplied and your own private 
libraries (source statement, relocatable, and core image) . Please note that the 
procedure library can only be a system library; the system does not support private 
procedure libraries. 



PLANNING SUMMARY 

The following considerations and decisions should be made before system generation, refer 
also to Figure 1-1: 

• Determine if one of the IBM-supplied supervisors fits your needs. The supervisors are 
pre-compiled and can therefore save you the lengthy process of defining, assembling, 
and link-editing. More information on these supervisors is given under "Supervisor 
Nucleus", for details refer to the "Memorandum to Users". 

• Select supervisor options by coding a set of supervisor macro instructions (see 
"Chapter 3: Planning the System" in DOS/VS System Ma nagement Guide ) . 

• Determine the programs that are to be in the core image and relocatable libraries of 
each operational pack. 

• Utilize the serviceability aids recommended in DOS/VS Serviceability Aids and 
Debugging Procedures , GC33-5380, during system generation, by including applicable 
aids from the following list in your DOS/VS system (section numbers refer to sections 
in that manual) : 

Recovery Management Support (including Tape and Disk Error by Volume 
Statistics — Section 2-F) 

Fetch/Load, I/O, GSVC and QTAM traces, and the Transient Dump (Problem 
Determination Serviceability Aids, PDAIDS — Section 2-B) 

- DUMPGEN (DOS/VS Standalone DUMP Generator, with fornatting DUMP 
option — Section 2-A) 

DOSVSDMP (COS/VS high-speed Standalone dump program for both formatted and 
unformatted dump output — Section 2-A) 

LVTOC and the Library Display Program (including the Access Method Services 
Utility Aids — Section 2-C) 

Online Terminal Test (Teleprocessing Aids — Section 2-F) 

LSERV (Label Cylinder Display Program — Section 2-C) 

SDAIDS (System Debugging Aids — Section 2-B) 

• If the system supports private core image libraries (PCIL=YES specified in the FOPT 
macro) , determine which programs are to be placed in the private core image library or 
libraries. Under such a system, the linkage editor executes in any partition. You 
can link-edit most IBM-supplied programs for execution in a foreground partition and 
place them in a private core image library assigned to that partition if enough core 
storage is available to execute the link-edited prograir. If desired, the version to 
execute in the background partition may be retained in the system core image library. 
It is not necessary to have different versions of a particular program for execution 
in different partitions, if the supervisor is generated to include the relocating 
loader. 
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You must place the supervisor (default name $$A$SUP1) in the system core image 
library. A supervisor cataloged to a private core image library cannot be used. 

The normal search order for loading phases into storage is as follows: 

• If the requested phase is a $$R phase (HCAR/CCH transient) , the system searches only 
the system core image directory. 

• If the requested phase is a $$A or $$B phase (transient) , the system first searches 
the system core image directory, then, if necessary, it searches the private core 
image directory assigned to the partition. 

For an attention routine command that results in a phase being loaded into virtual 
storage, DOS/VS searches only the system core image directory. Therefore, phases such 
buffer-image phases for an FCB or a DCB must be cataloged in the system core image 
library and not in a private core image library. 

If the phase is not found, the system enters the wait state with an error message of 
X»00000FF4» in bytes through 3 of low storage. 

When you request other phases, the system searches both the system and private 
directories, if necessary. If the phase name starts with $ r the system first searches 
the system core image directory and, if it does not find the phase, it then searches 
the directory of the private core image library, assigned to the partition. If the 
requested phase name does not begin with a $, the system first searches the private 
core image directory, then the system core image directory, unless SYS=YES is 
specified in the FETCH or LOAD macro, in which case the system directory is always 
searched first. 

To improve the performance of FETCH and LOAD in a multiprogramming system you can 
build an SDL (System Directory List) , containing the names of, and additional 
fetch/load information on, frequently used transients and phases. The SDL, however, 
is not searched for phases that are loaded by attention routines. The list is built 
as a result of the SET SDL=CREATE command and subsequent data statements. These 
statements can also be provided through an IBM-supplied cataloged procedure. 

Determine which modules are to be deleted from the relocatable library of each 
operational pack. Deleting from the relocatable library allows for expansion of the 
system core image library to hold a greater number of components. Refer to the 
relevant book module for each component for its sizes. 

Also determine if the macro definitions used to build the supervisor and IOCS modules 
are to be deleted from the source statement library. Retaining the macros in the 
source statement library facilitates building a new supervisor and new IOCS modules. 

With only one disk drive available you may prefer to maintain only enough room in the 
relocatable library of the operational pack to contain the modules for building the 
largest component in the system. This small relocatable library permits temporary 
insertion of any component in relocatable form. It can then be immediately 
link- edited into the system core image library and then deleted from the relocatable 
library. When the relocatable library is subsequently condensed, only the updated 
core image form of the component remains, thus conserving disk-storage capacity. 
Reducing the size of the relocatable library allows expansion of the system core image 
library. The expanded system core image library allows a greater number of programs 
to be online with a single system volume. 

Copy and restore programs are necessary to transfer the resident system from tape to 
disk, from disk to tape, from disk to cards, and from cards to disk for maintenance 
and backup purposes. 
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The procedures for the system configurations presented in this publication assume that 
the disk packs have been initialized with the VTOC on the cylinder shown below: 



Eevice used 


| VTOC 


on 


Cylinder 












I For System 


Packs 


| For Work Packs 


2314/2319 


I 199 






| or 199 


3330 Model 1 or 2 


| 403 






| or 403 


3330 Model 11 


| 807 






| or 807 


3340 (3348/35MB) 


I 347 






I or 347 


3340 (3348/70MB) 


| 695 






I or 695 


3350 


I 554 






| or 554 



MAPS AND LISTINGS PRODUCED DURING SYSTEM GENERATI ON 

All linkage editor output on SYSLST from the system generation procedure and any future 
updates (including maps produced by the linkage editor) must be retained. These maps 
provide necessary information on the level of the system and the load address 
(relocation) of each component. Similarly, all assembly listings produced during system 
generation, in particular supervisor and POWER/VS listings, should be retained. These 
maps and listings can be used by the systems programmer and the customer engineer 
maintaining the system. 



28 DOS/VS System Generation 



Q 



(Siflttflflnniafl N 
Decide on the number 1 
of system disks _J 



Repjan_ 

Modify the desired 
system to fit into 
available space 




Qptipns_ 

1. Select options 

2. Calculate 
real storage 
space 



Private Core 
lrnage_ybraryJl 
1 . Select programs 

to reside in 

this library 
[ 2. Calculate 

library size 



System Core 
!mafle_Library_ 
1. Select programs 
to reside in core , 
image library 
1 2. Calculate 
library size 




6 



h During a search operation, private 
libraries are searched BEFORE 
system libraries, except when 
searching core image libraries for 
phase names beginning with $. 



Private Relocatable 

Library* 

1 . Select programs 

to reside in 

this library 
\2. Calculate 

library size 



System Procedure 

Library_ 

1. Select procedures/ 
to reside 
in this library 
[2. Calculate 
library size 



System Relocatable 

Library 

1 . Select programs 

to reside in 

this library 
\2. Calculate 

library size 




Private Source 
Sjtaterjrant_Ljbrary_ 

1. Select books to 
reside in 
this library 

2. Calculate 
library size 



System Source 
Stjrtenrentjjbrary. 
1. Select books 

to reside in 

this library 
, 2. Calculate 

library size 








Figure 1-1. INTRODUCTION — Planning Summary 



Module 1: Planning and Procedures 29 



System Configuration 

This section presents the minimum system configuration required to operate DOS/VS. The 
system control programs and basic IOCS must always be present to execute any other 
programs. In view of the many different possibilities of attaching I/O units to the CPU 
models supported, the minimum machine requirements for the Model 115 CPU and the Model 
125 CPU are listed separately. The requirements for the CPU Models 135, 138, 145, 148, 
155-11, and 158 are listed together. 

MINIMUM MACHINE REQUIREMENTS - MODEL 115 

A System/370 CPU Model 115. 

Standard instruction set (See Note 1) . 

One Card Reader: 1442**, 2501**, 2520**, 2540**, 2560*, 2596**, 3505**, 3525**, 

or 5425* (See Note 2 and 3). 
One Card Punch : 1442**, 2520**, 2540**, 2560*, 2596**, 3525**, or 5425* 

(see Note 2 and 3) . 
One Printer : 1403**, 1443**, 3203* (Model 1 or 2), or 5203* (with or without UCS) 

(see Note 2). 

One Integrated Display Operator Console, optionally with a 5213 Console Printer attached. 
One 3340* Model A2 Disk Storage. 

* These devices are natively attachable to the Model 115. 

** These devices must be attached to the Model 115 via a multiplexer channel. 

Notes ; 

1. Language translators may require extended instruction sets. 

2. One 7- or 9-track 3410-3411 or 3420 (Model 3 or 5) series magnetic tape unit, or a 
disk extent may be substituted for this device. If a 7-track tape unit is used, the 
data conversion feature is required, except when the unit is substituted for a 
printer. 

3. The IBM 3540 Diskette I/O Unit may substitute for this device. In a cardless system, 
at least one 3741 or 3742 data entry unit is required to have a record insert feature 
to support program maintenance requirements. 

MINIMUM MACHINE REQUIREMENTS - MODEL 125 

A System/370 CPU Model 125. 

Standard instruction set (see Note 1) . 

One Card Reader: 1442**, 2501**, 2520**, 2540**, 2560*, 3504*, 3505**, 3525*, or 5425* 

(see Note 2 and 3) . 
One Card Punch : 1442**, 2520**, 2540**,, 2560*, 3525*, or 5425* (see Note 2). 
One Printer : 1403*, 1443**, or 3203* (Model 1 or 2) (see Note 2). 

* These devices are natively attached. Attachment of Card Reader/Punch devices is as 
follows, either 

One 350 4, or 

One 3504 and one 2560, or 

One 3504 and one 3525, or 

One 2560. or 

One 3525, or 

One 3504 and one 5425, or 

One 5425. 

** This device may either be natively attached, or be attached to a multiplexer channel. 

One Model 125 Integrated Display Operator Console, optionally with a 5213 Console Printer 

attached. 

One 3333 Model 1 Disk Storage, natively attached (two disk storage devices) , or 

One 3340 Model A2 Disk Storage. 
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Notes : 



1. Language translators may require extended instruction sets. 

2. One 7- or 9-track 3410-3411 or 3420 (Model 3 or 5) series magnetic tape unit, or a 
disk extent may be substituted for this device. If a 7-track tape unit is used, the 
data conversion feature is required, except when substituted for a printer. 

3. The IBM 3540 Diskette I/O Unit may substitute for this device. In a cardless system, 
at least one 3741 or 3742 data entry unit is required to have a record insert feature 
to support program maintenance requirements. 



MINIMUM MACHINE REOUIBEMEMTS - HODEL 135, 138. 145, 148, 155-11. 01 159 

A Systes/370 CPU Model 135, 138, 145, 148, 155-11, or 158, 

Standard instruction set (see Note 1) . 

One Card Reader: 1442, 2501, 2520, 2540, or 3505 (see Note 2). 

One Card Punch: 1442, 2520, 2540, or 3525 (see Note 2). 

One Printer: 1403, 1443, 3211 (see Note 2), 3203-4 (for Models 138 and 148 only), or 3800 

One 3210/3215 Console Printer Keyboard, attached to the sultiplexer channel, or 
One 3277 Operator Console for the Model 138 and 148. 

One 2314* Direct Access Storage Facility, or 

One 2319 Direct Access Storage Facility,, natively attached or 

One 3333 Disk Storage, Model 1, attached either natively or through a 3830-2 Storage 
Control Unit (see Note 3), or 

One 3330 Disk Storage, Model 1, 2*, or 11, attached through a 3830-1 Storage Control 
Unit (see Note 3 and 4) , or 

One 3340 Disk Storage, Model A2, attached through (see Note 4): 

a. the IFA (Integrated File Adapter) on the System/370 Model 135, or 

b. the ISC (Integrated Storage Control) on the System/370 Model 14 5, or 

c. the 3830-2 Storage Control Unit on the System/370 Models 135 and 145, or 

One 3350 Direct Access Storage, attached through: 

a. the 3830-2 on the Systes/370 Model 135 and higher, or 

b. the ISC (Integrated Storage control) on the Systes/370 Model 145 and higher. 

* The siniaus DOS/TS configuration requires two DASD spindles, one of which east be with 
removable pack, or one DASD spindle and tiro ■ agnatic tape drives. If the tape units 
are 7-track, the data conversion feature is required. 

Notes : 

1. Language translators may require extended instruction sets. 

2. One 7- or 9- track 2400 or 3400 series magnetic tape unit, or a disk extent may be 
substituted for this device. If a 7-track tape unit is used, the data conversion 
feature is required, except when substituted for a printer. Neither the tape unit 
nor the disk extent can be substituted for the card reader as the communication 
device during system IPL time. 
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3. The 3333 Disk Storage (unless natively attached) and the 3330 Disk Storage* Hod el 1, 
2* or 11 t require a high-speed selector channel. 

4. Requirements and specifications relating to the 3330 apply also to the 3333 and 3350 
in compatibility mode of the 3330-1. Those given for the 3340 apply also to the 

3344. 



MNOTES DURING SUPERVISOR ASSEMBLY 



During supervisor assembly, the assembler may generate MNOTEs- You may choose to ignore 
some by accepting the assumed values given in the MNOTEs. For others,, you may have to 
interrupt procedures* modify one or more specifications and reassemble the supervisor. 

Some general procedures for resolving MNOTEs are: 

1. Go to the DIAGNOSTICS section at the end of the supervisor assembly listing; it 
includes references to the MNOTEs generated during assembly. Each MNOTE reference is 
in the form 

statement-number IPK216 MNOTE GENERATED 

2. Using the statement number, go back into the listing and examine each of the MNOTEs. 
A severity code precedes the message portion (the higher the code, the more severe 
the error). Each MNOTE is listed after the macro with which it is associated. 

3. Determine the reason for the MNOTE. The MNOTE message indicates the parameter in 
question and usually provides a clue to the type of discrepancy. Some errors to look 
for are: 

• Misspelled items or mispunched numbers. 

• Parameters that are incompatible with other parameters in this or another macro. 

• Parameters that are outside the valid limits. 

4. Make any necessary changes and reassemble. If you have no changes to make (in other 
words, the assumed values listed in the MNOTEs are acceptable), continue with the 
generation procedures. Some errors are so severe, however, that no object deck is 
generated, and you must correct one or more macros and reassemble before continuing. 

CATALOGING THE SUPERVISOR 

The Supervisor Select function enables you to select different tailored supervisors,, 
cataloged in the core image library of your operational pack. Cataloging these 
supervisors can either be accomplished by specifying the ID parameter in the SUPVR macro, 
which only changes the last character of the supervisor name, or by changing the PHASE 
statement punched during supervisor assemblies, in which case you are free to select your 
own 8-character supervisor name. It is recommended to name the most frequently used 
supervisor $$A$SUP1„ since it is the default of the Supervisor Select function. During 
multiprogramming, the supervisor $$A$SUP1 cannot be cataloged. 

You can select the desired supervisor during IPL tiae by 

pressing the LOAD key on the CPD panel; when the systes enters the wait state* press 
the REQUEST/ENTER key on the console. When sessage 0103 A SPECIFY SUPERVISOR HARE is 
displayed* type in the nase of the desired supervisor fir. press the BID or EVTER key to 
select the default SSiSSUPI. 

Example : 

Specify ID=x in the SUPVR macro 

Catalog the supervisor. When performing the IPL procedure* specify $$A$SUPx. 
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The Supervisor Generation Macros 

This section defines the macros and their parameters required to generate an 
installation-tailored supervisor for DOS/VS. 

Note that the supervisor must be assembled with ALIGN=YES (assumed default value) in 
the STDJC macro instruction, because ALIGN=NO causes performance degradation and may 
result in assembly errors. 

RULES FOR USING SUPERVISOR GENERATION MACROS 

1. The assumed value default for an omitted parameter is underlined in the following 
discussion. Wherever an alternate default is possible, both operands are underlined. 

2. Braces O indicate that you must select one of the enclosed values. 

3. Bracketed operands are optional, for example, [n] . 

4. Replace the letter n in a parameter with a decimal number. 

5. The name field must be blank. The operation field always contains the mnemonic 
operation code. The operand field contains the parameters. 

6. For any given macro, several parameters may be contained on one line. Separate each 
parameter with a comma. No embedded blanks are permitted. Continuation cards are 
permitted (nonblank character in column 72; the continue column is column 16). 

7. In the expression X'cuu', replace cuu with the hexadecimal number for channel and 

unit. 

8. The macros must be issued in the following sequence: SUPVR, CONFG, STDJC, FOPT, 
PIOCS, VSTAB, ALLOC, ALLOCR, IOTAB, DVCGEN, ASSGN, DPD, SEND. 

9. The DVCGEN, ASSGN, ALLOC, ALLOCR, and DPD macros are not required. They are 
specified if input/output tables (DVCGEN) are being specified, if standard 
assignments (ASSGN) are being made, if storage is allocated (ALLOC and ALLOCR), or if 
the page data set (DPD) is defined at system generation time. 

10. An END statement and a /* statement must follow the SEND macro instruction. 

11. Figure 1-4 shows the device type codes of the DOS/VS supported devices used for 
system generation, 

SUPVR 

The (SOPVR) Supervisor macro and its parameters define the system as disk resident with 
the ability to support certain desired functions, such as multiprogramming, HICR, or 
teleprocessing . 

PARAMETERS FOR SUPVR 

i NO\ Specify if multitasking support is desired. Multitasking allows 
AP=(YEs/ the execution of more than one program within a partition. 

Specification of AP=YES is required if TP=VTAM is specified and 
also if you want to use the ATTACH, DETACH, ENQ, and DEQ macros for 
your programs. AP=YES must be specified if support for POWEE/VS 
with EJE,SNA is required. 

WAITM=YES is forced by AP=YES. An invalid specification of AP 
causes YES to be forced. If AP=YES is specified and NPAETS is 
omitted or specified as 1, NPAETS=3 is forced. 

Module 1: Planning and Procedures 33 



/ Npl Specify if supervisor support of ASCII/EBCDIC translation tables 
ASCII=lYESj is desired. ASCII^YES must be specified if support of ASCII tapes 
by magnetic tape IOCS is required. 



/ N0\ A specification of CHAN=YES is required if multiplexer 
CHAN=(YESJ channel-attached devices, tape units, or teleprocessing devices 



(Models 115 
nd 125 only) 



are present on your Model 115 or 125 CPU- Software recording is 
performed for channel-attached devices and for tape units only. If 
these devices are part of the system, a check is made during IPL to 
see if RMS error recording support is provided; if it is not, the 
system enters a hard wait state. RMS=YES overrides a specification 
of CHAN; it should be specified if full error recovery is required 
in addition to error recording. For detail information, refer to 
DQ2ZJ.5 Serviceability £i£s afi£ Defcuaaina Procedures. 



(RDE) Specify to include RDE (Reliability Data Extractor) recording in 
ERRLOG^I YES f addition to normal RMS error recording. RDE causes recording of 

"End of Day" via the ROD operator command and of the cause of IPL. 
This provides additional data for installation and IBM evaluation 
of system performance. The PDE option does not require any 
additional real storage. 

If RDE recording is desired for a Model 115 or 125 CPU, normal RMS 
error recording support must be generated by specifying CHAN=YES or 
RMS=YES. 

Note : For reasons of compatibility with earlier DOS releases, 
ERRLOG=(YES,RDE) may still be specified. Specification of 
ERRLOG=YES has no effect since error recording is controlled by the 
MODEL- parameter or, for a Model 115 or 125, by CHAN= and RMS=. 
Specifying ERRLOG=( YES, RDE) is identical to specifying ERRLOG=RDE. 

i No) Specify EU=YES if you require mixed parity tape processing for the 
EU=(YES/ 14xx emulators and the tape preprocessor and tape postprocessor 
programs. EU=YES need not be specified to run these programs if 
mixed parity tape processing is not required. 

Note : For reasons of compatibility with earlier DOS releases, 
specification of EU=RELOC is accepted by the assembler as if EU=YES 
had been specified. 



ID={cJ 



Specify this parameter if you plan to use the Supervisor Select 
option. You can assign a unique name to the supervisor being 
generated by specifying any alphameric character (A-Z,l-9) in this 
field. For example, if you specify ID=A, then the supervisor will 
be named $$A$SUPA when it is placed on the core image library. If 
this parameter is omitted the supervisor will be named $$A$SUP1. 



MCH 
(Models 115 
or 125 only) 



/YES) 
=4 NO/ 



This is an option for CPU Models 115 and 125 only. Do not specify 
this parameter for CPU Models 135 and up. For these models, 
support for the Machine Check Analysis Recorder (MCAE) and Channel 
Check Handler (CCH) features is standard. 

MCH=YES in conjunction with CHAN=YES is equivalent to specifying 
RMS=YES. In addition to the software recording services generated 
by specifying CHAN=YES, specification of MCH=YES generates the 
error recovery (MCAR and CCH) portion of RMS. 
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MICR=< 1 
111 



( NO) 
\ 1419> 
fmi9D) 



Specify if the supervisor is to support magnetic ink character 
readers or optical reader/sorters. If 1255/1259/1270/1275s are 
to be supported, indicate 1419. 1419D indicates Dual Address 
Adapter 1419/1275s only; 1419 support does not provide 1419D 
support. If 1419s or 1255/1270/1275s are attached to a multiplexer 
channel, BMPX=YES should be specified in the PIOCS macro. However, 
burst mode and MICR devices cannot run concurrently on the same 
byte-multiplexer channel - A warning MNOTE to that effect is 
issued. Please note that 3 886 Optical Character Readers do not 
require MICR support. 



NPARTS=<3 



Specify the number of partitions to be supported. The maximum 
value of n is 5. For reasons of compatibility with earlier DOS 
releases, MPS=YES, NO, or BJF is also accepted by the assembler. 



The default tak e n is 1 if : 

The AP, MPS, POWER, and TP parameters are either not specified, or 
specified as NO. 

The default taken is 3 if any of the following is specified ; 

AP=YES 
MPS=YES 
POWER=YES 
TP=QTAM 



If NPARTS is omitted or is specified as 1, specification of any of 
these parameters forces NPARTS=3. 



PAGEI 



(NO) Specify that paging activity i 
N=\ n( RELPAG, and FCEPGOUT macros. 



s to be controlled by the PAGEIN, 



(See DOS/VS Supervisor and I/O Macros , for a complete description 
of these macros.) 



PHO: 



( NO) 
>=\YESj 



POWER 



( NO) 
= (YESj 



The value n indicates the maximum number of page- in requests that 
can be queued at any one time for execution. Each PAGEIN macro 
issued in a program represents a page-in request. To obtain 
support for the three macros, the values specified for n must be 1 
or larger. 

Specify if page exception handling overlap (PHO) is desired. 
PHO=YES allows control to be passed to a user routine while a page 
fault is being handled. Specification of PHO=YES is required if 
you want to use the SETPFA macro in your programs. (For more 
details see the DOS/VS System M an a gement Guide . ) When PHO=YES is 
specified, PFIX=YES is forced. PHO=YES is forced if POWER=YES is 
specified* 

Specify if support for POWER/VS is desired. If POWER=YES is 
specified, the following options are forced: PHO=YES and NPARTS=3 
(if NPARTS was not specified or if NPARTS=1 was specified) in the 
SUPVR macro, PFIX=YES and ECPREAL=YES in the FOPT macro. 



/ NO) Specifying RMS=YES is equivalent to specifying both CHAN=YES and 
RMS=)YESf MCH=YES. RMS=YES overrides any specification of CHAN and/or MCH. 
(Models 115 If RMS=NO is specified, or if the parameter is omitted, the 
and 125 only) generation of RMS support is governed by specifying the CHAN and/or 

MCH parameters. RMS=YES is required if the string switch feature 
is installed. EMS=YES should be specified if a multiple partition 
system is used. EMS=YES is forced if TP=VTAM. 
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N0\ Specify if teleprocessing is desired and, if so, whether Basic 
VTAmJ (BTAM), Queued (QTAM), or Virtual (VTAM) Access Method is desired. 
TP= I BTAM[, VTAM} > When QTAM is specified, support for BTAM is also included. If ETAM 
QTAM [, VTAM] | runs in virtual mode, PFIX=YES is required- For QTAMn, n is the 
[QTAMn [,VTAM] ) maximum number of message processing programs in the system at any 
one time. n may have any value from 2 to 12. If VTAM is specified 
and also for multitasking, AP=YES must be specified. If AP=NO and 
QTAMn are specified, n is forced to 2. If TP=QTAM or TP=VTAM and 
NPARTS=1 or is omitted, NPARTS=3 is forced. 

If both BTAM and VTAM, or both QTAM (or QTAMn) and VTAM are 
specified, the operands must be placed between parentheses, for 
example, TP= (BTAM, VTAM) . 

Specification Of VTAM forces AB=YES, ECPREAL=YES, GETVIS=YES, 
IT=YES, OC=YES, PC=YES, PFIX=YES, RELLDR=YES, TOD=YES, WAITM=YES, 
and RMS=YES in the case of Models 115 and 125 in the FOPT macro. 

If POWER=YES is specified and your version of POWER/VS is to 
support RJE,SNA, TP=VTAM must be specified. 



CONFG 



The CONFG (Configuration) macro instruction and its parameters define the system 
configuration and can specify generation of optional supervisor services. 

PARAMETE RS FOR CCNFG 

/ NO) Specify only if your CPU has the floating-point feature. 
fp=\yes/ 

HODEL=modelttu*b©r[ -suffix ] 

Specify the model number of the CPU and the suffix if applicable. 
Omission of this parameter or an invalid specification causes 
supervisor generation to be terminated. 

Specify: 

M0DEL=115 for the IBM 3115-0 and 3115-2 CPU 

MODEL=125 for the IBM 3125-0 and 3125-2 CPU 

MODEL=135 for the IBM 3135 and 3135-3 CPU 

MODEL=138 for the IBM 3138 CPU 

MODEL=145 for the IBM 3145 and 3145-3 CPU 

MODEL=148 for the IBM 3148 CPU 
MODEL=155-II for the IBM 3155-11 CPU 

MODEL=158 for the IBM 3158 CPU 

If M0DEL=115 or 125 is specified, the generation of Recovery 
Management Support (MCAR/CCH and/or RMS error recording) is 
dependent on the specification of the RMS, CHAN, and MCH parameters 
of the SUPVR macro. For all other CPU models,, RMS-support is 
standard, 

jjj otes: 

For reasons of compatibility with earlier DOS releases, 
specification of MODEL=155 is accepted by the assembler. Support 
for the Model 155-11 CPU is generated. 
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When MODEL=125 is specified, support for the 3330 disk is always 
generated (if not specified otherwise in the DISK=parameter of the 
PIOCS macro). When MODEL=115 is specified, support for the 3340 
disk is always generated. 

The storage protection and decimal features have be*n made 
standard. The Interval Timer is a standard System/370 hardware 
feature. If, however, you specify SP=, or DC= (whether the 
operand is YES or NO) , the assembler will accept your 
specification and merely react by generating an MNOTE, which 
need to be resolved. TIMEK=YES is also acceptable but 
generates no code. 

If you plan to run your generated system on more than one CPU 
model, you should specify the larger model number. 



STDJC 



The STDJC (Standard Job Control) macro instruction and its parameters specify the 
standard settings for job control. If the assumed options are all satisfactory, the only 
entry required is the STDJC macro instruction itself, without any parameters. Th ese 
sta n dard options, except LINES and DATE, can be temporarily overridden by an OPTION 
statement, LINES can be overridden by a SET com m and, DATE by a // DATE statement . 



PARAMETERS FOR STDJC 



ALIGN 



ACANCEL 



CHARSET: 



( YES ) 
N=( NO/ 

i no) 

;=|YES/ 



U8C\ 

=\60CJ 



(MDYi 
DATE= (,DMYJ 

JYES\ 

DECK=\ NO/ 

DUMP =< NO> 

(part; 



EDECK 



ERRS 



i NO) 
i=\YESJ 

= \ NO/ 

{56} 

LINES'- inn/ 

(yes) 

LIST=\ NO/ 

LISTX=(YES/ 



Specify if the assembler is to align data on halfword or fullword 
boundaries, according to the type of instruction used. A 
supervisor must be assembled with option ALIGN=YES to avoid hard 
waits.. 

Specify if Job Control is to cancel jobs automatically 
(ACANCEL=YES) or to wait for operator intervention (ACANCEL=NO) 
after an unsuccessful attempt to assign a device. (Please note 
that the LOG command suppresses the ACANCEL function.) 

Specify either the 48- or 6 0-character set for PL/I translator 
input on SYSIPT. 

Specify the format of the date MDY=ironth/day/year . 
DMY=day/month/y ear . 

Specify if language translators are to produce object modules 
on SYSPCH. 

Specify if a dump of the registers and virtual storage is to be 
written on SYSLST in case of an abnormal program end. PART 
specifies that a dump of the supervisor control blocks and the 
virtual storage of the partition is to be written on SYSLST. 

Specify if the assembler is to create and punch edited macros 
on SYSPCH. 

Specify if compilers are to summarize all errors in source 
programs on SYSLST. Assembler and PL/I always assume ERRS=YES. 

Specify the number of lines per page on SYSLST. The minimum 
is 30; the maximum is 99. 

Specify if language translators are to write source module 
listings and diagnostics on SYSLST. 

Specify if compilers are to write hexadecimal object module 
listings on SYSLST. 
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( YES ) Specify for a listing of all control statements on SYSLST. 
LOG=\ NO; LOG=NO suppresses the listing of all job control statements on 

SYSLST. Invalid statements and coirrrands will be listed on SYSLST 
if it is assigned. 

/ NO_l Specify RLD=YES if the relocation dictionary information is to be 
RLD=lYES/ printed. 

(NO) Specify if the 6SYSPARM assembler system variable symbol is to 
SPARM= lYES/ be supported. 

(NO) SYM=YES may be specified if the PL/I compiler is to produce a 
SYM=(YEs/ symbol and offset table listing on SYSLST, or if American National 
Standard COBOL is to produce a data division glossary. 

/ YES ) Specify if the assembler is to write symbolic cross-reference 
XREF=t NO) lists on SYSLST, or if American National Standard COBOL is to 
produce a cross-reference listing. 



FOPT 



The FOPT COptional Features) macro and its parameters specify additional optional 
features that can be included in the supervisor. 



PARAMETERS FOR FOPT 

/ NO) Specify if the abnormal termination exit function is to be 
AB=\yes{ supported. The abnormal termination exit, invoked via the STXIT AB 
macro,, allows you to exit to a user's routine before an abnormal 
end-of-job causes a program to be canceled. Specify YES for 
American National Standard COBOL I/O error recovery. AB=YES is 
forced if TP=VTAM is specified in the SUPVR macro. 

(NO) Specify the number of I/O requests for the operator console to be 
CBF=\ nj buffered. Under the following conditions operator console I/O 
requests will be buffered: 

1. The actual record to be written does not exceed 8 characters. 

2. Data or command chaining is not performed. 

3. The CCB associated with this operation does not indicate the 
acceptance of unrecoverable I/O errors, posting at device end, 
or user error routines. 

4. The CCB does not request sense information. 

CBF=NO is forced if HODEL=115, 125, 138, or 148 is specified 
together with DOC=125D or 3277. 

Console buffering allows overlap of CPU processing with write 
operations to SYSLOG by satisfying the requestor's WAIT 
immediately, rather than at I/O completion time. When this option 
is selected, the number of CHANQ entries should exceed the number 
of CBF entries so that the buffering process is not bound by the 
number of CHANQ entries. If the assumed option is taken for .CHANQ 
and CBF is selected, the number of CHANQ entries is assumed to be 
six more than the CBF entry. Numbers 1 through 5 are valid, and 
one is assumed if the operand is invalid. 
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(NO ^Specify if supervisor DASD file protection is desired when n»,n* 

DASDFP=\ (n l # n 2 [, 2321 J) f indicates the range of channels to which DASDs nay be attached. 

Specification of n l ,n 2 provides file protection for disk devices. 
For reasons of compatibility with previous releases, specification 
for all disk devices are accepted, but are treated as 
documentation (that is, the parameters are ignored). File 
protection for the 2321 must be specified and provides protection 
for all DASD devices. DASDFP prevents writing outside the extents 
cf a file in case of program error. Extents are protected to the 
nearest cylinder except for 2321, where they are protected to the 
nearest head bank. This feature does not protect the file from 
being Overwitten. 

Notes: 

1. No file protection is provided for the IBfl 354 Diskette 
Input/output Unit. 

2. The IOTAB parameter JIB-n allocates storage for DASDFP 
extents. 

3. If a disk device type is specified by the third operand and 
this disagrees with the one as specified by the DISK parameter 
of the PIOCS macro, the value of this parameter will overrule 
the one specified by the third operand. 

!NO } Specify if supervisor support for a display operator console (DOC) 

125D V is to be generated. DOC=125D and DOC=3277 generates the supervisor 

32 77 ) routines that allow SYSLOG assignment to a 125DOC or a 3277. 

If DOC support is generated, support for 3210/3215 console printer 
keyboards is generated as well. If 125D is specified for a Hodel 
138 or 148, console support is provided in 115/125 DOC emulation 
mode; for details, see DQS/VS Operating, Proc ed ures. The 3277 is 
supported as operator console on all System/370 models to which it 
is attachable. Support Of the 125DOC and the 3277 as operator 
console communication device is mutually exclusive. The APL 
feature with 3277 is not supported. 

The default taken depends on the CPO model specified by the HODEL 
parameter of the CONFG macro. If HODEL-115 or 125, the default is 
125D. If HODEL=138 or 148, the default is 3277. For any other 
HODEL specification, the default is NO. 

iNO ) Specification of this parameter allows use of the VIRTAD macro, the 
ECPKEAL= (YES/ EEALAD macro, and of the EXCP macro with the HEAL parameter. 

For good performance of the SOFT/VS program, this option 
(ECPREAL=YES) should be specified. ECPEEAL=TES forces PFIX=JES. 
ECPBEAL=YES is forced if POWES=YES or TP=?TAN is specified. 

!5i This parameter is optional. It is intended primarily for tele- 

3 ? processing systems with a large number of communication lines or 

n) devices. It specifies the number of entries to be generated for the 

error queue. The default and minimum number is 5 if the system is 
generated to support multiprogramming. The default and minimum 
number is 3 if multiprogramming is not supported. The maximum 
value of n is 25. 

(NO ) Kagnetic tape error volume analysis is supported (may be used with 

EVA= \ (r,w)/ or without TEBV) . When the number of temporary read errors that 

occurred exceeds the value of r, the operator is notified via a 
message on SYSLOG. The maximum value for r cannot exceed 254. 
EVA=(r,w) forces TAPE=7. 

flhen the number of temporary write errors that occurred exceeds 
the value of w, the operator is notified via a message on SYSLOS. 
The maximum value for w cannot exceed 254. 
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FASTTR 



= \yes( 



After the operator aessage the systea resets the temporary error 
count to zero and continues noraal processing. 

Specify if fast CCW translation is to be supported. 

Past CCW translation attempts to save and reuse any channel 
prograns that have been translated, and to keep the pages 
containing the I/O areas fixed, providing the paging rate is not 
seriously affected. Fast translation is attempted for all channel 
prog ra is except: 

1. Those containing non-contiguous CCS strings. 

2. Those associated with translation requests froa BT&R (BTAR 
nakes special use of CCW translation) . 

Note that the specification of FASTTR=IES affects the default and 
xiniaua values for the BOFSIZE=n paraaeter in the TSTAB aacro. 

j NO ) specify TES if storage aanageaent support using the GETVIS and 

GETVIS= (YESj FREE VIS aacro instructions is desired. GETYIS=YES is forced if 

VSAM=YES, RPS=YES, or if TP=VTAH is specified in the SOPVR aacro. 

GETVIS=YES forces RELLDR=YES. For 3800 printer support, GETVIS 
storage management is required. 

Specify YES if your systea includes the IBH 3344 or 3350 and the 
Analysis Prograa-1 (AP-1) will be invoked. 

iS.0 \ Specify IDEA=YES if the IDRA (Independent Directory Bead-in Area) 

IDRA= (YES/ is desired. IDRA=YES allows the systea to read the directory 

containing the location of the phase specified in a FETCH or LOAD 
into the IDFA instead of using the Systea Error Recovery Procedure 
transient area. Thus, with the IDRA feature, throughput aay 
increase when .an error recovery procedure is in progress. 
IDBA-YES is valid only if the NPARTS paraaeter in the SUPYR aacro 
specifies aore than one partition. 

| NO \ Specify if the interval tiaer can be handled by problea prograas. 

IT= (YES/ IT=YES generates tiaer support for ail tasks in all partitions* 

It allows use of the STXIT IT and SETIHE aacros. IT=TES is forced 
if TP=VTAH is specified in the S0P¥B aacro. 

Specify YES if you will invoke the IBB Analysis Prograa-1 (AP-1) 
and your systea includes 3344s or 3350s. 

Sote : For reasons of coapatibility with earlier DOS releases, 
specification of IT s BG, F1, or F2 is accepted by the asseabler. 
Tiaer support for a^ll tasks in all partitions is generated as if 
IT=YES had been specified. 

!fiQ | Specify if DOS/FS Job Accounting Interface is to be supported. 

YES ; JA=YES indicates support of each partition. 

(n*,n*,n*,n*,n*)J 

JA=(n*,n*,n',n*,n«) specified additional support of SIO count for 
I/O devices, and J A* YES is generated. The values substituted for 
n*,n*,n s ,n 4 , and n* indicate the nuaber of 1/0 devices per 
partition for which SIOs are to be counted. The aaxiaua value for 
n for any partition is 255; n* always specifies the nuaber for the 
background partition. 

The partitions to which n* through n* refer depend on the nuaber 
of partitions in the systea, as is shown below: 

n* n* n* n» 



2 


partitions 


F1 






3 


partitions 


F2 


F1 




a 


partitions 


F3 


F2 


F1 


5 


partitions 


F4 


F3 


F2 



F1 
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If no SIO count is required for a given partition, no value should 
be supplied. However, the operand delimiter (coaia) must be 
submitted if other values follow. 

For example, if NPABTS=5 and JA=(10, # 3) are specified, STO count 
is supported for: 

10 I/O devices for the background partition 
I/O devices for the F4 partition 
3 I/O devices for the F3 partition 
I/O devices for the F2 partition 
I/O devices for the F1 partition 

If you plan to use the job accounting support of POWEF/VS, specify 
either JA=YES or «JA=n ,n ,... 

(NO ) Specify for support of user-written job accounting routines 
JALIOCS= ((s, 1)j containing LIOCS, and LIOCS with label processing. If you specify 

JALIOCS= (s,l) , JA=YES or (n* ,n*,n 3 ,n*,n s ) must be specified as 

well. 

s and 1 reserve a user save area and a label area equal to their 
specifications (that is, if s equals 25, then a 25-byte save area 
is reserved), s can be any decimal number in the range 0-1024. 
If s is omitted, or if JALIOCS=NO, a 16 byte user save area is 
still reserved in the supervisor if JA#NO is specified. 1 can be 
any decimal number between and 224. 

(NO \ Specify if operator-initiated communication is to be handled by 

OC= uES I problem programs. Allows use of the STXIT OC macro. If YES is 

specified, the facility is available to all partitions generated. 
YES is required if emulator program operator services are to be 
requested through the interrupt key. If FETRIN=YES, OLTEP=YES, or 
1P=VTAM is specified, 0C=YES is forced. 

(YES) Specify OLTEP=YES if the online testing function is desired. 

OCTEP= (NO { CLTEP*YES allows the online test executive program to execute. 

If OLTEP=YES, then FELLDB=YES and OC=YES are forced. 
Specification of BETAIN=YES forces OLTEP=YES to be generated. 

(NO ) Specify if user programs may use STXIT PC macro. QTAfl, RPG II, 

PC= (YES( FOETBAN IV, COBOL-D, and PL/I require PC=YES. If TP=VTAH is 

specified in the SUPVF macro instruction, PC=YES is forced. 

(NO ) Specify if private core image libraries are to be supported. These 

PCIL= \ YES f have the same format as the system core image library on SYSBES. 

You may assign private core image libraries to any partition. If 
the linkage editor is to run in a foreground partition, a private 
core image library must be uniquely assigned to that partition. 
You may link-edit many iBB-supplied programs to run in a 
foreground partition and place them in a private core image 
library to be assigned to that partition. PCIL=NO forces PSLD=N0. 

(NO ) The PD parameter must be specified if the problem determination 

PD= (YES/ programs (PDAIDS) are desired. PD=YES specifies that a minimum 

FDAEEA or 1,400 bytes is reserved for this function. Any amount 
between 1,400 (SDAlDs do not need a generated area) and 10,240 
bytes may be specified for n. 

(NO ) Specify if the supervisor is to support the fixing and freeing of 

PFIX= |YESJ pages by means of the PFIX and PFFEE macro instructions. PFIX=IES 

is forced if POHEB=YES, PH0=YES, or TP=7TAH is specified 
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PRTY= 

(partition name 
sequence) 



in the SOPVR macro or if ECPREAL=YES is specified. PPIX=YES is 
required if you plan to execute BTAH programs in virtual node. 

Specify, by means of a partition name sequence, the desired 
dispatching priority for each partition. The partition specified 
first has the lowest priority, the partition specified last has 
the highest priority. Specify all the partitions for which support 
is generated by means of the NPARTS parameter of the SOPVB macro 
or by default; do not specify PRTY if NPARTS=1. 

the partition default priority is as follows: 



Number of 
partitions 



Default priority (low to hiqh) 



BG,F1 
BG,F2,F1 
BG,F3,F2,F1 
BG,F4 # F3 # F2,F1 



PSfc 



LD= |n / 



EELLDR 



<YES) 



RETAIN 



= \XESJ 



{no ( 

EPS= \ YES/ 



Specify the number of entries in the Private Second Level 
Directories. A directory is created for each partition, unless 
PCIL=NO. The minimum value for n is 5. PSLD=NO is assumed if the 
parameter is omitted or incorrectly specified. For good 
performance n should be equal to the largest number of actually 
used directory tracks of a private core image library. PCIL=NO 
forces PSLD-NO. 

Specify if the supervisor is to include the relocating loader. This 
facility allows programs to be loaded into partitions, independent 
of their link-edited addresses. SELLDR=YES is forced by BPS=YES, 
VSAH=YES, GETYIS=YES, OLTEP=YES, EETAIN=IES, or TP=YTAH. 

Mote : If the supervisor is generated to include the relocating 
loader, the function can be suppressed at link-edit time by means 
of an »ACTION NOBEL* statement. 

The EETAIN function is available on the Model 145 in the United 
States of America and Canada only. EETAIN is an OLTEP function that 
allows the OLTEP programs initiated from a remote location to be 
executed. RETAIN is a problem determination tool used by IBM. If 
this function is to be used, specify RETAIN= YES and include the 
IBM 2*955 Retain Communications Device in the P0B table. External 
interruptions are required for RETAIN operation; therefore, if 
BETAIN=YES is specified, OC=YES, OLTEP=YES, and RELLDB=YES are 
forced. 

Specify to include support for the Rotational Position Sensing 
capability of IBM 3330/3333, 3340, and 3350 Disk Storage devices. 
EPS support permits the device to disconnect during access are 
positioning operations, thereby freeing the channel to service 
requests for other devices on the channel during the latency 
period. If RPS=YES is specified, GETVTS=YES and EELLDR=YES in the 
FOPT macro and BLKMPX=YES in the PIOCS macro are forced. 



Sotes: 

1. The RPS support is suppressed if the NPARTS parameter in the 
SUPVR macro specified support for one partition only 
(NPARTS=1) . 
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2. Specification of RPS=YES eliminates the need to specify 
SKSEP=YES for devices that have the RPS feature and block 
multiplexing support. SKSEP=YES can be specified for DASD 
devices that do not have the RPS feature or for DASD devices 
connected to selector channels or IFAs, in order to free the 
channel during seek operations. 

3. Specification of RPS=YES is required if your system includes 
DASDs of type 3330-11 or 3350 and you intend to use these 
devices for processing sequential or direct-access files with 
programs that were written for accessing these files on other 
IBM DASD types without recompiling or reassembling these 
programs. 

No ) Specify if SEEKs are to be separated from the remainder of channel 
SKSEP=^YES/ programs. Seek separation allows other devices on the channel to 

n* be accessed (including other seeks) during the seek. YES indicates 
support for all DASD type devices specified by the DVCGEN macro at 
system generation time. n is the number of DASD devices to be 
supported and cannot be less than the number of DASD devices 
specified at system generation. The maximum is 2 54. 

Note : If all DASD devices in your configuration have DCC 
(Disconnect Chaining) capability and if they are attached to block 
multiplex channels, channel overlap during SEEKs is more 
efficiently handled by Block Multiplex Channel Support (specify 
BLKMPX=YES in the PIOCS macro). In a mixed DASD configuration, 
that is a configuration consisting of DASDs with and without DCC 
capability, specify either SKSEP, or SKSEP and BLKMPX. 



>M 



Specify the number of entries in the Second Level Directory. The 
SLD=ln/ minimum value for n is 5. This is the default value if the 
parameter is omitted or incorrectly specified. For good 
performance n should be equal to the number of actually used 
directory tracks in the system core image library. 



i Np) specify SYNCH=YES if the use of an IBM-provided program requires 
SYNCH=(YESj the synchronous exit facility (SVC screening). 



j NO I 

<YES > 
((YES,n 1# n a )) 



Specify if system input and system output files (SYSRDR, SYSIPT, 

SYSFIL={YES } SYSLST, SYSPCH) in any partition may be assigned to a disk device 

or an IBM 3540 Diskette I/O Unit, or, if support for the procedure 
library is desired. Specification of YES gives support for all 
disk devices and the IBM 3540 Diskette Input/Output Unit. In a 
configuration without tape, specification of SYSFIL=YES is required 
for system maintenance purposes. If the emulator program parameter 
SYSIO is specified with a value ranging from 200 through 233, a 
value must be specified for SYSFIL. 

n x = residual capacity for beginning of operator notification when 
SYSLST assigned to disk. 100<n-L <65535. If n*. is omitted, 
1000 is assumed. 

n 2 = residual capacity for beginning of operator notification when 
SYSPCH assigned to disk. 100<n 2 <65535. If n 2 is omitted, 
1000 is assumed. 

Notes : 

1. If neither n x nor n 2 is specified, the operand need not be 
placed between parentheses () . 

2. Neither n ± nor n z may be specified if the logical units are 
assigned to an IBM 354 Diskette Input/Output Unit. 

(NOV Specify if tape error statistics are to be accumulated and logged 
TEB=\ nf for the 2495 Tape Cartridge Reader, where n is the number of tape 

cartridge readers attached to the system. Choose a value of n that 
allows for possible future expansion of the system. 
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i IR) Specify how tape statistics are to be automatically accumulated 
TEBV=\cr/ in the PUB2 table and logged on the SYSREC file. For all standard 
labeled tapes, tape statistics are accumulated by volume. For 
unlabeled or nonstandard labeled tapes two types of error recording 
are available: 

• Combined Recording (CR) 

• Individual Recording (IR) 

When TEBV=CR is specified, the error statistics for all nonstandard 
and unlabeled tapes on a specific tape unit are accumulated until a 
standard labeled tape is mounted and opened on that unit. Then one 
recording of the statistics for the nonstandard, unlabeled tapes is 
made and the counters are reset in the PUB2 table. 

Specify TEBV=IR to record tape error statistics on the SYSREC file 
and reset the PUB2 table counters at each OPEN for nonstandard and 
unlabeled tapes. 

i NO_l Specify if time-of-day clock support is desired. If YES is 
TOD=\YESj specified, GETIME macro support is provided. Every time a GFTIKE 
is issued, the date fields in the supervisor communication regions 
are updated, if necessary. TOD=NO forces ZONE=NO. If TP=VTAM is 
specified in the SUPVR macro instruction, TOD=YES is forced. 

(NO) Specify if the track hold function is to be supported. 
TRKHLD=\ n/ Specification of TRKHLD generates support for the DASD Track 

Protection macros. When processing sequential disk work files or 
updates to direct-access files,, specify if a hold is to be placed 
on the track of the record being read. The hold prevents anyone 
else that is using track hold from accessing that track. Tne 
maximum number of tracks that can be held at one time is 2 55. The 
default is 10 if n is an invalid parameter (nonnumeric or outside 
the range 1-255). The NPARTS parameter in the SUPVR macro must 
specify more than one partition if TRKHLD=n is specified. 

Note: The track hold function is not supported for the IBM 354 
Diskette I/O Unit- The track hold function must be specified if 
VSAM files with the attribute SHAREOPTIONS (4) are processed. For 
details refer to DOS/VS Access Method Services U s er's Guid e, 
GC33-5382. 

(NO \ Specify if the task timer support is to be generated in the 
TTIME=\partition Id( supervisor. The partition-ID (BG, F1, F2, etc.) designates the 

partition that owns the task timer. 

Support must be generated for the partition that owns the task 
timer by corresponding specification in the NPARTS parameter of the 
SUPVR macro. For example, with NPARTS=2 specified, valid 
partition-ID specifications are BG or F1; if NPARTS=3 is specified, 

partition- ID, BG, F1 , or F2 is valid. If the partition designation 
does not correspond to the appropriate NPARTS specification, or if 
the value specified for NPARTS is invalid, an MNOTE is issued. 

The task timer requires that the clock comparator (an optional 
hardware feature) and the CPU timer be installed on the System/370 
Models 135 and 145. 

USERID=id Specify if you want a supervisor id to be printed as part of the 
IPL COMPLETE message. id may be up to 16 bytes long. If you 
specify more than 16 bytes, the id will be truncated on the right. 
If you specify less than- 16 bytes, the id will be padded with 
blanks on the right (do not place the id within quotes, embedded 
blanks are not allowed) . 
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The specified id is placed in the 16 byte area that immediately 
precedes the background communication region. The field contains 
blanks if the parameter is not specified. 

/• l?P\ Specify if support of VSAM (Virtual Storage Access Method) or of 
VSAM=\YESj the 3800 Printing Subsystem is desired. YES is forced for 

GETVIS and RELLDR if VSAM=YES is specified. If NRES is not, or 
incorrectly, specified in the IOTAB macro, VSAM=YES forces NRES=10. 
For 3800 support, VSAM=YES is required so that the CDLOAD routines 
are included in the supervisor. If VSAM support is not wanted, 
the VSAM phases can be deleted (see "Link-Edit and Delete 
Procedures") . 



/ NOV Specify if the multiple wait function is to be supported. This 
WAITM=|YESJ function allows you to use the WAITM macro to wait for one of a 
number of events to occur. WAITM=YES is forced if AP=YES or if 
TP-VTAM. 

* 

Specify YES if you vill invoke the IBM Analysis Prograe-1 (AP-1) 
and your systen includes 3344s or 3350s. 

NO ) Specify YES or n if support for Cross-Partition Event Control is 
XECB=<YES> desired. If YES is specif ied, four XECBs (Cross- Partition Event 
n; Control Blocks) are generated per partition (as specified in 
NPARTS) . 

For n, specify a nuaeric value; it indicates the nueber of XECBs 
for which an entry is to be generated in a supervisor internal 
table. The niniaua nuaber you should specify for n is 4. If you 
specify less than four, the specification is ignored and XECB-4 is 
assuned. The naxiaun nuaber you should specify for n is 8*NPARTS. 
If you specify a nuaber greater than 8* NPARTS, the specification is 
ignored and 8*HPARTS is assuned. Cross-Partition Event Control is 
not supported If IPAHTS«1 is specified. XECB support Bust be 
specified if SPOOL- YES (in the POWER/VS generation aacro POWER) is 
specified. 

Specify YES or n if you plan to utilize the cross-partition 
support of POWER/VS. 



!NO 
(EAST,hh,mm) 
(WEST,hh,rom) 



For time-of-day clock support, specify the difference between 
GMT (Greenwich Mean Time) and local time in hours (hh) and 
minutes (mm) . Specify EAST for areas to the east of the meridian 
of Greenwich, United Kingdom, or for areas whose time is in advance 
of GMT. Specify WEST for areas to the west of the meridian of 
Greenwich, United Kingdom,, or for areas whose time is behind GMT. 
The value used in the ZONE parameter is used to obtain the local 
time of day. If the parameter is not specified, or incorrectly 
specified, or if TOD^NO is specified, ZONE=NO is forced. If the 
first operand is incorrectly specified, EAST is assumed. 

You can change the zone value (default is GMT) every time you 
perform the IPL procedure, by specifying any zone value in the ZONE 
parameter of the SET control statement. 



Notes: 

1. Information on the macro instructions STXIT„ EXIT, SETIME, and TTIMER is contained in 
the DOS/VS Supervisor and I/O Macros .. 

2. The PTO (Physical Transient Overlap) feature and command chaining support for retry 
on I/O operations (CCHAIN) , optional in earlier releases of DOS, have been made 
standard. If, however, you erroneously specify either PTO or CCHAIN (whether the 
operand is YES or NO), the assembler will accept your specification and react only by 
generating an MNOTE, which you need not resolve. 
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PIOCS 



The PIOCS (Physical Input/Output Control System) macro instruction and its parameters 
define the configuration requirements to be supported by physical IOCS. If the assumed 
options are all satisfactory, the only entry required is the PIOCS macro itself, without 
any parameters. 



PARAMETERS FOR PIOCS 



i no\ 

BLKMPX= lYESj 



Specify if block multiplexing is to be supported. Block 
multiplexing is useful in a configuration with 3330, 3310, and 3350 
Disk Storage devices and the following buffered card and print 
devices; 2540, 1403, 3211. 

Note 1,: In a DASD configuration that consists of 3330, 3340, and 
3350 Disk Storage devices, there is no need to specify SKSEP=YES or 
n in the FOPT macro as block multiplexing provides channel overlap 
during SEEKs in a more efficient way. Moreover, the code generated 
by a specification of SKSEP=YES is then bypassed if BLKHPX=YES is 
specified. 

Note 2 : If your CPU is a Model 3115 or 3125, Block Multiplexing 
must not be specified in conjunction with the use of the 
2311-1/3330, 2311-1/3340, and 2314/3340 Series Compatibility 
Features. 

i NO) Specify if burst mode devices are supported on a byte-multiplexer 
BMPX=\YESJ channel. If overrunnable devices are attached to the 

byte- multiplexer channel, BMPX=YES should be specified. However, 
burst mode and MICR devices cannot run concurrently on the same 
byte-multiplexer channel. Specify BMPX=YES if: 

• Attached devices operate in burst mode, or 

• Overrun problems have been experienced. 



Otherwise specify BMPX=NO. 

NO ) Specify if channel switching for tape control units is to be 
CHANSW=< RWTAU? supported. For a 2404 or 2804, enter CHANSW=RWTAU. For a 2816 
ITSWTCH) (with a 2403 or 2803) or a 3803 enter CHANSW=TSWTCH. If 

CHANSW=RWTAU or TSWTCH is specified and TAPE=NO is specified, 
TAPE=7 is forced. Channel switching allows a device to be 
addressed via two adjacent selector or block-multiplexer channels. 



,1 



DISK= 



2311 

2314 

3330 

3340 

3350 

(3330,3340) 

(3330,3350) 

(3340,3350) 

(3330,3340,3350) 



Support for the XBM 2311, 2314/2319. Specification of DISK=33xx 
gives support for all attachable DASD devices of the type 
specified. If support for more than one type of DASD device is 
required, each type must be specified. For example, to provide 
'support for 3330s and 3340s, specify DISK= (3330,3340) . This 
provides no support for 3350s. 

Note ; DISK=3340 is the only valid specification for the Model 115. 
Specification of DISK=2311 , 2314, or 3350 is not valid for Model 125, 
If Model=115 and DISK^3340, DISK=3340 is forced. If MODEL=125 and 
DISK^3330 or 3340, DISK=3330 is forced. 



/ NO\ Specify if MICR device is on the selector channel (can only be 
MRSLCH= (YESj specified for the 1419 single address device). 



TAPE= 



(no) 



Specification of TAPE=7 generates support for both 7- and 9-track 
tape. TAPE=7 is forced by a specification of EVA=(r,w) and by 
CHANSW=RWTAU or TSWTCH. If MODEL=125 or 115 and TAPE=7, or 9, 
CHAN=YES must also be specified. In a configuration without tape, 
specification of SYSFIL=YES is required for system maintenance 
purposes. 



46 DOS/VS system Generation 



Page of GC33-5377-6, revised July 15, 1977, by TNL GN33-9226 

li2i§ ! : Selector channel support is standard in DOS/VS. The parameter SELCH=, 
used in prior DOS releases, is ignored. 

fiotg 2: A Display Operator Console (DOC) must not be attached to the same selector 
or block multiplexer channel as SYSBES. 



VSTAB 



The VSTAB (Virtual Storage Table and Buffer Build) macro instruction and its parameters 
define the size of the teal and virtual address areas and of the SVA (Shared Virtual 
Area) , and specify the number of buffers required for channel program translation. 
Tables, for mapping the real and virtual address areas, and buffers are generated within 
the supervisor area. The maximum value you can specify for VSI2E is 16,384K (16,777,216 
byted) minus the size specified for the real address area (RSIZE) . Specification of this 
macro is requir ed . The VSTAB macro is discussed in greater detail in the D Q S /V S System 
Management G ui de. 



PARAMETERS FOB VSTAB 

VSTAB RSIZE=(96^l ,VSIZE=/NPABTS*64K«-SVA sizel( ,BTJFSIZE*n ],SVA= fi64K x 0K}) 
(nKJ (nK~ J \ 7nK,m?) / 

BSIZE=nK Specify the size of the real address area, where n must be > 6ft and a 

multiple of 2. If an odd number is specified, a value of 1 is 
added to it. If the operand is omitted, a value of 96K is 
assumed. The value specified is used to build the tables that map 
the real address area and to define the beginning of the virtual 
address area. (End of real address area = beginning of virtual 
address area.) 

If you select a value for RSIZE that is larger than the amount of 
real storage in the CPO model used for system generation (with an 
eye to also using your system on a CPtJ with larger real storage) , 
the address area between the end of real storage and the beginning 
of virtual storage will not be used. 

If you select a value for RSIZE that is smaller than the actual 
amount of real storage in the CPff on which your system is to be 
used, any real storage beyond your RSIZE cannot be used, and a 
warning message is issued at IPL time (provided that you IPL from 
the console keyboard), informing you that a part of real storage 
is not used. If you IPL from the card reader, however, the 
message is suppressed. 

VSIZE= ( I£ AB Jj§* 64 Kj Specify the size of the virtual address area (which includes the SV\), 
< ♦SVA, size > where n must be at least 64 times the number of partitions specified 
(nK J by the NPARTS parameter and a multiple of 2, plus the size of the 
SVA. If an odd number is specified, a value of 1 is added to it. 
If VSAH is to be used, the partition in which it is to run should 
have 302K bytes plus sufficient space for buffers and control 
blocks (see book Hodule 17: VSAH) ; if the VSAH phases are to be 
loaded into the SVA, the latter must have 302K bytes. 

If Access Hethod Services is to be used, it requires up to 450K 
bytes in the partition in which it is to run, depending on the 
functions that are to be performed (refer to the section • Storage 
Requirements' in book Hodule 17: VSAH) . If the operand is 
emitted, a value of 64 times the number of partitions specified by 
the NPASTS parameter is assumed. The value specified is used to 
luild the tables that map the virtual address area, to determine 
the size of the disk extent for the page data set, and to define 
the end of the virtual address area. 
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BUFSIZE=n Specify the number of copy blocks {buffers with a length of 7 2 

bytes) to be used by the Channel Prograa Translation routine. 
Specification of this paraaeter is optional. For further details, 
refer to DOS^YS Systea Hanaqe a e nt Gu ide, Chapter 3 under • Defining 
the Nuaber of CCW Translation Buffers*; 

The following table shows the ainiaua value that can be specified 
and the default value that is used if the operand is oaitted. 



r — -- ** 

1 

JFASTTR= 


1 
JNPARTS- 


I 


B0FSIZE= 
Default 


Hiniaua 


I — — - — 
J NO 


1 


n=1 


i 


10 




I 


10 


I HO 


i 


n>1 


I 


30 




I 


10 


|YES 


1 


n=1 


I 


30 




I 


30 


| YES 


1 


n>1 


130 


+ {(n-1)*20) 


I 


30 



The maximum value that Bay be specified for B0F5IZE is 4 50. For 
EPS add 20X aore buffers. For teleprocessing terainals supported 
under BTAf! specify three blocks for each locally-attached 2260 or 
3270. For reaote devices specify three blocks plus one additional 
block if the DECB extension facility is used, plus one additional 
block for each BTAH buffer specified for the device. If VSA«=YES 
is specified, add 40 blocks. VSAH uses these copy blocks only 
during actual I/O and iaaediately frees thea after use. 

If the terainals are attached to aultidrop lines, copy block 
assignaent should be by line, not by device. For large 
teleprocessing network it is sometimes possible to assign fewer 
buffers. One way to determine if enough buffers have been 
specified is to use the DOHP command, specifying the begin and end 
address of the buffer area in the supervisor. If all blocks have 
been used then probably too few buffers were specified. 

SVA= ( I6U5aPJS;1 I nK specifies the size of the SVA; aK specifies the size of the 

((nK.aK) / system GETVIS area in the SVA. n must be at least 64 and a aultiple 
of 2. a aust be smaller than n and also a aultiple of 2. If the 
operand is oaitted or incorrectly specified, the default value is 
taken. If the SVA is to be used for VSAH phases, specify 
SVA= <302K,0K> . 

The systea GETVIS area aust be large enough to accommodate all RPS 
logic module phases that will be dynamically loaded, plus at least 
2K aore for the LDL used by EPS. A specification of SVA=(nK,40K) 
is adequate for a typical program. If all the RPS logic nodules 
are to be pre-loaded, as for example when using 
Checkpoint/Restart, a specification of SVA= ({n + 88) K,6K) will be 
adequate. 

Kote _1: This parameter is only valid if the NPARTS parameter of 
the S0PVR macro specifies more than one partition (NPARTS>1). The 
size specified can be changed by the SVA paraaeter of the SET job 
control coaaand. 

ygte gz If TP=VTAH, the value calculated for the VTAH space 
requirement in the SVA aust be included in the specification of 
the SVA. 
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ALLOC 

The ALLOC (Allocate) macro instruction defines the partitioning of the virtual address 
area in a multiprogramming system. Specification of th is macro is opt i onal beca u se the 
operator can also allocate the virtual storage address area. It can only be specified 
with at least one parameter. Specify the size of the virtual foreground partitions only. 
The system computes the size of the virtual background partition by subtracting the total 
amount of virtual storage allocated to the virtual foreground partitions from the virtual 
address area as specified by the VSIZE parameter. When specifying the ALLOC macro, see 
to it that the size of the background area does not fall below 64K bytes. If VSAM with 
Access Method Services is to be used, the partition in which they are to run should have 
480K bytes plus enough space for buffers and control blocks. If VSAM phases are loaded 
into the SVA, the SVA must have 302K bytes and the partition 302K bytes plus enough space 
for buffers and control blocks. If the macro is omitted, the entire virtual address area 
is allocated to the virtual background partition and the size of each virtual foreground 
partition defined is set to zero. The ALLOC macro must not be used if NPARTS=1 is 
specified. 

PARAMETERS FOR ALLOC 



ALLOC Fn=mK[ ,Fn=mK]... 



The operands may be specified in any order, m must be a multiple of 
2. If an odd number is specified, it is replaced by the next 
higher even number. The minimum value substituted for m may not be 
less than 64. A zero specification is accepted, however. Any 
specification from 1 through 63 is reset to zero, n is the 
partition number and can range from 1 to NPAETS-1. 

If the sum of the sizes specified for all foreground partitions plus 
the SVA plus 64K exceeds the size as specified by the VSIZE 
parameter,, the ALLOC macro is ignored by the assembler, which issues 
an MNOTE to that effect. 

Areas Used by the System 

All partitions contain a partition save area for program name, 
interrupt status information, and registers, as well as a label save 
area for label processing if the LBLTYP job control statement is 
used. Both areas are at the beginning of the partition. 

Save area length is 88 bytes, or 120 bytes* if the floating-point 
feature (FP=YES) was specified in the CONFG macro. 

• Please note that no floating-point register save area is created 
for a one-partition system (NPARTS=1). 

Labe l area length is determined by the system according to the LBLTYP 
specification: 

• TAPE (standard tape labels) =80 bytes 

• NSD (nn) (nonsequential disk) =84 bytes plus 20 bytes per EXTENT 
statement 

• Omitted = bytes. 

The size of each virtual partition must be large enough to contain 
both the program and the save areas. 
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ALLOCR 

The ALLOCR (Allocate Real Storage) macro instruction allocates available real storage to 
your partitions (as defined by the NPARTS= parameter of the SUPVR macro). 

In a multiprogramming system, available real storage is the real storage size of your 
CPU as specified by the RSIZE parameter of the VSTAE macro, less the size of your 
supervisor. In a single partition system (NPARTS=1) specification of the ALLOCR macro is 
not accepted. All available real storage is always allocated to the background real 
partition. 

The ALLOCR macro instruction is optional, since available real storage can also be 
allocated or reallocated by means of the ALLOCR command. ALLOCR must be specified with 
at least one parameter. Specify the size of each real partition you desire (including 
the background partition). If a partition is omitted, it is allocated a real partition 
size of zero. All available real storage not allocated to real partitions is allocated 
to the main page pool. In order to determine the minimum size required for the main page 
pool, refer to "Planning the system" in Chapter 3 of DOS/VS System Management Guide. 
Programs executing in virtual mode and using the PFIX macro instruction require an 
allocated real partition whose size is not less than the maximum number of pages 
concurrently fixed by PFIX. 

All of available real storage may be allocated to real partitions except for a minimum 
page pool requirement as indicated below: 

• If PFIX=NO -- 18K minus the size of the smallest real partition of 0-18K. 

If SDL is active, the main page pool must be at least 4K. 

• If PFIX=YES and AP=NO — 18K. 

• If PFIX=YES and AP=YES — 20K. 

• If phases from the SVA are to be executed and AP=NO — 18K. 

• If phases from the SVA are to be executed and AP=YES — 20K. 

In a single partition system (NPARTS=1) , all available real storage is permanently 
allocated to the background real partition (EGR). 

During IPL, the partition allocations of real storage are checked to assure that 
sufficient storage for the page pool has been reserved. If the allocation exceeds the 
maximum allowed, all real partitions are set to zero, and a message is issued. The 
operator can correct the problem with an ALLOCR command. 

PARAMETERS FOR ALLOCR 

ALLOCR BGR=mK[ ,FnR=raK]. . . 

The operands may be specified in random order, m must be a multiple 

of 2. If an odd number is specified, it is replaced by the next 
higher even number. For each real partition allocated, the 
corresponding virtual partition must be allocated too, because the 
job control program runs in virtual mode. 

n is the partition number and can range from 1 to NPARTS-1. 

Areas Used by the System 

The size of each active real partition must be large enough to 
contain both the program to be executed and the partition and label 
save areas (see the description of the ALLOC macro) . 
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IOTAB 



The IOTAB (Input/Output Tables) macro instruction and its parameters define the area for 
the necessary device tables for the system. If the assumed options are all satisfactory, 
the only entry required is the IOTAB macro itself without any parameters. 

PARAMETERS FOR IOTAB 



BGPGR 



flOl Specify the number of symbolic programmer logical units (SYS000- 
=\ nf SYSnnn) assigned to the background partition. The minimum number 



-{*} 



BSCLNS 
(Models 115 
and 125 only) 



CHANQ=J 8 



10] 

8| 

- 

nl 



is 



10. The maximum depends on the number of partitions, 
discussion of parameter FnPGft, below. 



See the 



If the TP parameter in the SUPVR macro indicates BTAM or QTAM 
teleprocessing support, or if POWER/VS is used for RJE applications, 
and the MODEL parameter of the CONFG macro specifies 115 or 125, 
this parameter specifies the number of BSC lines in the system. The 
value given must be in the range of 0-4 for the Model 115 and 0-6 for 
the Model 125. (This parameter is not required for VTAM. ) 

Specify the maximum number of entries to be generated for the 
channel queue. If the parameter is omitted, a default is taken as 
follows: 

The value specified by the CBF parameter of the FOPT generation macro 
plus 

6 if HPARTS=3 or less 

8 if NPA£TS=4 
10 if NPARTS=5 

The default value is also taken if the specified value is smaller 
than the default. 

The number of entries specified should exceed the total number of I/O 
requests you wish to accumulate simultaneously. The requests for I/O 
commands for all channels are stored in this queue and are not 
released from the queue until the I/O operation has completed. The 
maximum value generated is 255. (See the DOS/VS System Management 
Guide , for a detailed discussion of this parameter. ) 



D2311=n 
D2314=n 
D2321=n 
D2400=n 
D3330=n 
D3340=n 
D3350=n 
D3410=n 
D3420=n 
D3540-n 
D3800=n 
D3886=n 



Specify, for the I/O device types listed at the left and as 
applicable to the installation configuration, the number of drives 
(for disk and tape devices) or the number of units installed (for 
3540s, 3800s, and 3886s). 

If the device is not specified, the system assumes that no devices 
of that type are attached. However, defaults other than zero are 
taken depending on the CPU Model specified and (for tape devices) 
whether PIOCS tape support is generated or not (see table below) : 



I Default | PI OCS 
I I 
I I 

| TAPE 



I 

|D2314=2| 

I \ 

|D2400*4| 

I I 

(D3330-2I 

I I 

I D3 340= 2 1 

I 



S) 



♦ 

|D3410«2| 



COVFG Hacro 



M0DEL»1 15 | MODEL- 125 



HODEL*135, 138, 145, 148, 
155-11, or 158 
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I The number specified for each device may be more than the actual 

number attached, but if the tota l number of devices specified exceeds 
the number of devices specified in the IODEV parameter, the latter 
number is upgraded (total number of devices specified by the Dxxxx 
parameters plus 5 for unit record devices) . 



FnPGB 



-iJLl Specify the number of symbolic programmer units (of the class SYSnnn) 
~\mf for the foreground partition F1. The ainiaua value for a is 5, and 



the aaxiaua is 241. 



Specify the nuaber of syabolic prograaaer logical units (of the class 
STSnnn) for the renaining foreground partitions, again, the ainiaua 
value for a is 5, vhile the aaxiaua depends on the nuaber of 
partitions specified. 

The aaxiaua nuaber of prograaaer logical units is 241 for partition 
F1; for the reaaining partitions, the sua of logical units you can 
specify is 

241 if NPABTS=1 

241-14*<n-1)-1 if NPARTS=2 or aore. 



IODEV 



-H) 



In the foraula, n equals the value specified in the NPABTS 
paraaeter. 

If the nuaber of foreground prograaaer logical unit exceeds the 
number of 8G LUBs, STSnnn in the extent statement vill fail in the 
checking routine when running // OPTION STDLABEL. The user can aake 
the BGPGR equal to the FnPGB or use // OPTION PARSTD in the 
foreground partition. 

Specify the nuaber of I/O devices attached to the system. The 
aaxiaua is 254. The ainiaua value is 4. Each unit requiring a 
DVCGEN or ADS entry aust be included in n. 



JIB 



-M 



NRES= 



m 



Specify the number of JIBs (Job Information Blocks) for t ne system, 
Requirements are: 

1. One JIB for each logical unit temporarily reassigned by a 
// ASSGN statement. 

2. One JIB for each alternate logical unit assignment. 

3. One JIB for each open 2311, 2314, or 2319 extent with the DASD 
file-protect feature except for system input/ output extents. 

4. Two JIBs for each open 2321 or 33xx extent with the DASD 
file-protect feature. 

The minimum value generated is 5. The maximum is 255. 

Indicates the number of Resource Usage Records (RURs) . This 
parameter is only valid if VSAM was specified in the FOPT macro, r 
must be a value between 2 and 255. If NRES is not specified and 
VSAM=YES, NRES=10 will be assumed. To compute the optimal upper 
limit for n, apply the formula 

n=(2*UCAT*NVRLC*l)*P+NVRLC+NUPGS+l 
where 
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UCAT is the number of user catalogs that are open at the same time. 

NVRLC is the number of volumes of a recoverable catalog that contain 
an open VSAM file. 

P is the number of partitions. 

NUPGS is the number of upgrade sets that are open at the same time. 

All these values should reflect the situation that exists at a point 
in time when NPES assumes its maximum value. 



SSLNS 
(Models 115 
and 125 only) 



-® 



The value for NRES thus calculated will cause sufficient space to be 
reserved for the variable resources to be used. However, depending 
on the application, the number of resources actually required most of 
the time may be much lower. 

Note: If the value substituted for n is too small and the pool of 

named resources gets exhausted, the VSAM partition is canceled with 
message 0S16I displayed, unless there is a possibility of a resource 
being freed by another partition. 

If the TP parameter in the SUPVR macro indicates BTAM or QTAM 
teleprocessing support and the MODEL parameter of the CONFG macro 
specifies 115 or 125. This parameter specifies the number of Start/ 
Stop lines in the system. The value given must be in the range 0-8 
for the Model 115 and 0-16 for the Model 125. (This parameter is not 
required for VTAM.) 



DVCGEN 

The DVCGEN (Device Generation) macro instruction and its parameters define the physical 
input and output units attached to the system. This macro instruction is optional. The 
DVCGEN macro is further discussed in the DQS/VS Systeir Management Guide . 

PARAMETERS FOR D VCGE N 

CHUN=X'CUU' ,DVCTYP=xxxxxx f CHANSW=|NO I ,MODE=X'ss' 

\yes/ 

CHUN=X'cuu' Specify the hexadecimal number of the channel and unit for the 

device. If channel switching is supported, c must indicate the lower 
channel. 

DVCTYP=xxxxxx specify the type of device. Figure 1-4 contains the codes for each 

IBM-supported device. 



CHANSW: 



: (YES/ 



Specify if the device is attached to more than one channel on one 
system, that is 

a. Two selector channels 

b. Two block multiplexer channels, or 

c. One selector channel and one block multiplexer channel. 

Note : DOS/VS requires that the channels have consecutive addresses 
(for instance channels 1 and 2). 



This parameter indicates whether the device can be switched (IBM 2816 
(with a 2403 or 2803), 3803, 2804 or 2404 is available! . 
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MODE= 



X'ss' 
X'ssss' 

X" ssssss* 



1. 2400T9. MODE specifies the tape irode. X'CO' is the default 
value. For 800 bpi 9-track single density, specifying X'C8' 
saves time during tape OPEN. 

2. 3410T9. MODE specifies the tape irode. X'CO* is the default 
value. 

3. 3U20T9. HODE specifies the tape mode. X^O* is the default value for 
both single and dual density tape. 

4. 2400T7 or 3420T7. MODE specifies the tape mode. X'90' is the 
default value. 

5. 2702. MODE designates the SADxxx command. 

X*00» SADO (default) 

X'Ol' SAD1 

X'02 f SAD2 

X'03* SAD3 

See Figure 1-13 for other values of ss. 

6. 2260 (Local) and 3270 (Local). MODE specifies the 1053, 3284, or 
3286 printer when CHUN=X*cuu* refers to a 1053 attached to a 
2848, a 3284 attached to a 3272, or a 3286 attached to a 3272, 
respectively. The operand must be entered as MCDE=X*01'. Note : 
3270 (local) must be specified as DVCTYP=3277. 

7. 1419/1255/1259/1270/1275. MODE designates the external interrupt 
bit associated with magnetic ink character readers or optical 
reader/sorters. The mode X'01' - X'20' corresponds to external 
interrupt PSWs bits 26 - 31, respectively. For dual address 
adapter 1419, this parameter is needed for both 1419P and 1419S. 

X'01* Device attached to external line 7. 

X*02* Device attached to external line 6. 

X'04' Device attached to external line 5. 

X'08* Device attached to external line 4. 

X'10* Device attached to external line 3. 

X'20* Device attached to external line 2. 



1018. MODE specifies whether the error-correction feature is 
present or not. 

X'00' feature not present (default value). 
X'01* feature is present. 

2703. For the IBM Models 115 and 125 with the Integrated 
Communications Adapter, MODE=x*ss', MODE=X'ssss ' , or 
MODE=X' ssssss' specifies the line mode setting for a Start/Stop 
or BSC line if the TP parameter in the SUPVR macro indicates ETAM 
or QTAM teleprocessing support, or if POWER/VS is used for RJE 
applications, and the MODEL parameter in the CONFG macro 
specifies 115 or 125. If a one or two byte value is specified, 
the specified value is right- justified and padded with zeros on 
the left to fill the three bytes. Thus, to specify a single-byte 
value for a Start/Stop line that requires only one byte, you must 
supply a three-byte value, the leftmost byte of which contains 
the requested mode settings. The line mode setting and its 
default settings are discussed in System/370 Model 125 Functional 
Characteristics , GA33-1506 and in System/370 Model 115 Functional 
Characteristics, GA33-1510. 
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10. 3704/370 5. MODE specifies the type of channel adapter. Wo 
default is assumed. 

X'01' Type 1 or 4 channel adapter 
X , 02 l Type 2 or 3 channel adapter 

If the MODE parameter is omitted or incorrectly specified, the 
assembler issues an MNOTE. 

RULES FOR USING DVCGEN 

1. A separate DVCGEN macro is required for each device. For a 2314, 2319, 3330, 33*0, 
3350, or 3540 each individual spindle needs a DVCGEN macro instruction. If one 
physical spindle contains two or more logical spindles, a DVCGEN macro must be issued 
for each of these logical spindles. 

Specify 2311 if a 3330 is to be used with the 2311-1/3330 Series Compatibility 
Feature (8040): also specify 2311 if a 3340 is to be used with the 2311-1/3340 Saries 
Compatibility Series (8060); specify 2314 if a 3340 is used with the 2314/3340 Series 
Compatibility Feature (8070) ; specify 3330 if a 3350 is used with the 3330/3350 
Compatibility Feature; specify 3330B if a 3350 is used in 3330-11 compatibility 
mode. 

A separate DVCGEN macro instruction must be made for each quadrant of the 3344 (in 3340 
mode). A separate DVCGEN macro instruction must be made for each half of the 3350 (in 
3330-1 compatibility mode). 

2. The total number must not exceed the total number of devices specified in the I0DEV 
parameter of the IOTAB macro. 

3. DVCGEN macros must be specified in ascending channel address sequence. 

4. Switchable units attached to more than one channel, that is 

a. Two selector channels 

b. Two block multiplexer channels, or 

c. One selector channel and one block multiplexer channel, 

must be defined only once on the lowest channel by which they are addressable. They 
cannot be redefined as nonswi tenable units on the higher channel. 

5. The sequence of the DVCGEN macro instructions determines the position of the devices 
in the PUB table. SYSRES should he the first DVCGEN macro instruction if it is to 
have the highest software priority for that channel. Switchable units must be the 
last devices specified for each channel and must be on consecutive channels. 

6. The specifications of these macros can be altered at 1PL ty ADD and DEL statements. 

7. IBM 3210/3215 Console Printer-Keyboards that are not online but were defined by 
DVCGEN macro instructions must be deleted by DEL statements when performing IPL from 
the card reader. 

8. For Models 115 and 125 with Integrated Communication Adapter, lines are reserved as 
follows: 

X'02x' for Start/Stop 
X'03x' for BSC. 

ASSGN 

The (ASSGN) Assign aacco instruction and its parameters assign symbolic device names 
(LUBs) to physical I/O devices (PUBs) . A separate macro instruction is reguired for each 
symbolic device name *i.th a standard systea generation assign Beat. This macro is 
optional, however, since tht? assignments can also he made after IPL- If the assignment 

is aade at system generation time, the system uses it as a default assignment. 
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PARAMETERS FOR ASSGN 



"' , t*]L«] 



SYSnnn,X , cuu t [", BG ~| |~, H 1 ~ ] SYSnnn may be any of the following system logical 

units: 

SYSRDR SYSLST SYSREC 

SYSIPT SYSLOG SYSRLE 

SYSPCH SYSLNK SYSSLB 
SYSCAT 

or a programmer logical unit (e.g. SYS000, SYS001) . 

If SYSnnn specifies a programmer logical unit, the range for nnn 
can be from 000 through to one less than the number of programmer 
logical units as specified in the corresponding IOTAB parameter. 

X* cuu' is the hexadecimal number of the channel and unit to 
which the symbolic device is attached. (If channel switching is 
supported, c must be the lower of two channel numbers.) A 
separate macro is required for each standard assignment desired. 

IS* ££ specifies the partition to which the assignment is being 
made; n can range from 1 to NPAETS- 1. The ASSGN macro is 
ignored if a specification is entered for a partition not 
defined by the NPAETS parameter of the SOPVR macro, or not 
defined by default if the NPAETS parameter was not specified. 
If the parameter is omitted, while the next parameter is 
specified, indicate the omission by separating the last and the 
next parameters by means of two commas. 

HI or H 2 specifies the desired input hopper to be used for an 
IBM 2560 or 5425. If both hoppers are to be used, they must be 
separately assigned to the same partition by means of two ASSGN 
macros. If the operand is omitted HI is assumed. 

Note: H2 may only be assigned to SYSRDR, SYSIPT, or SYSPCH. If 
the device is spooled by POWER/VS, SYSPCH cannot be the same 
physical device as SYSRDR/SYSIPT. If, in a particular 
partition, spooling is required from a read/punch device, a 
unique physical device address must be specified for both the 
read and the punch function (user dummy for at least one of the 
functions). For example, from a device with the physical address 
X'OOC'i, you cannot spool both the punch and the read function. 

Making a standard foreground assignment at system generation time is equivalent to making 
a permanent assignment after IPL. When you unbatch a foreground partition, temporary 
assignments are released. 

System I/O units (SYSRDR,, SYSIPT, SYSLST, or SYSPCH) that are assigned to a tape, a 
3540 Diskette, or DASD when the system is generated are unassigned by IPL. An unassigned 
device can cause a job to be canceled. 

Notes : 

• During system generation, conflicting assignments (ASSGN macro specifications made in 
the supervisor assembly) across partitions are not checked. 

• The device address for SYSLOG is specified explicitly by means of an attention 

interrupt during the IPL procedure. This causes DOS/VS to automatically assign the 
interrupting device to SYSLOG and to override the SYSLOG assignment generated in the 
supervisor. 

• Compile, link-edit, and go in a foreground partition is allowed only if a private core 
image library is supported and available. Therefore, SYSLNK must be assigned to a 
foreground partition if PCIL=YES has been specified and NPARTS>1. Note that tne 
assignment can also be made at execution time. 

• At IPL time, non-operational DASD devices are indicated as being physically unavail- 
able for system operations (Device Down) , tnus overriding the permanent assignment. 
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DPD 

The DPD (Define Page Data Set) macro instruction and its parameters define the page data 
set (SYSVIS) that is to hold the virtual address area. S pecification of this macro is 
optional, since t he data set can also be defined after I P L by means of the DPD command . 
It provides information about the channel and unit number of the paging device, disk 
starting address of the SYSVIS extent and the volume serial number. 

If the macro is omitted or incorrectly specified, the page data set rrust be defined at 
IPL time by means of the DPD command (see the DQS/VS Sys t em Management Guide). This 
command can also be used to override the information supplied by the DPD macro, until the 
next IPL. 

The IPL routines open the page data set, check its extent limits,, create label 
information for inclusion in the VTOC, and assign the symbolic name of SYSVIS to the page 
data set. 

Note ; The ASSGN statement or command cannot be used to assign or reassign SYSVIS. 

PARAMETERS FOR DPD 

DPD UNIT=X*cuu' ,CYL=nnn[,VOLID=xxxxxx] 



UNIT=X'CUU' 



CYL=nnn 



VOLID=xxxxxx 



Specify (in hexadecimal notation) the channel and unit number of the 
device that is to contain the page data set. (If UNIT is specified, 
then CYL must also be specified- ) 

Specify the number of the cylinder where the page data set is to 
begin. The upper limit of the extent is computed by the system on 
the basis of the information supplied in the VSIZE parameter of the 
VSTAB macro. The assembler issues an MNOTE indicating the required 
number of tracks. (If CYL is specified, UNIT must also be 
specified. ) 

This parameter is optional. It specifies the volume serial number of 
the disk pack and is used for label checking. If the parameter is 
not specified in either the DPD macro or the DPD command, the volume 
serial' number is not checked. 



SEND[n] 

The SEND (Supervisor End) macro instruction indicates the address of the problem program 
area (PPBEG) . PPBEG is always on a 2K boundary and coincides with the address at the end 
of the supervisor (EOSSP) . Regardless of whether the SEND macro is specified with or 
without the n parameter, the generated supervisor is always fully storage-protected. 

Choose a value for n only if you want to reserve extra space within the supervisor 
area for future expansion, or for other purposes described below. If a value for n is 
selected which is larger than the size of the generated code, extra space is reserved. 
The system will not claim the extra space, not even for additional CCW translation copy 
buffers. However, if n is not specified,, any extra space is used for these buffers. If 
the space reserved is sufficient for a future expansion of the supervisor, you will 
thereby avoid having to relink-edit non-relocatable programs, link-edited for the real 
background partition. In the meantime,, you may use the extra space to expand the Problem 
Program Determination Aids (PDAIDS) area. 

If your supervisor includes the relocating loader,, no relink-editing is required for 
programs that were link-edited relocatable for a real partition. Moreover, because the 
address of the virtual background area is independent of the supervisor end address, 
expansion of the supervisor never involves relink-editing of programs that are 
link-edited for a virtual partition. 

Note : The DQS/VS assembler requires an END and a /* statement following the SEND macro. 
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PARAMETERS FOR SEND 

n Specify the desired address (PPBEG) of the real address area for use by programs other 
than the supervisor. Depending on the value selected for n, the assembler takes the 
following actions: 



r t t t 

I n | n=multiple | n>size of | 

| specified? j of 2048 j generated j Assembler action taken 

| | | supervisor?) 

h + x x 

| YES | YES | YES (specification is accepted. 

>. x + x 

| YES J NO ] YES j Address specified is stepped up to next higher 
| I j J 2K boundary. 

j. x + + _ 

| YES | YES | NO | Address specified replaced by generated 

| | I j supervisor end address (PPBEG). 

h x x + 

| YES | NO j NO | Address specified replaced by generated 
| | | | supervisor end address (PPBEG). 

L X + X 



NO 



| Address of PPBEG established on 2K boundary. 



L X X X 



Figure 1-2. Supervisor End Address Computation on the Basis of Different SEND Macro 
Specifications 
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POWER=YES 




F 


F 


F 










F 




F 














F 




TP=QTAM 


F 


F 








F 




AP=YES 


F 




AP=NO 




F 




ECPREAL=YES 






EVA=(r,w) 


F 








CHANSW * NO 


F 




TOD=NO 




F 




PHO=YES 




F 




VSAM=YES 




F 




GETVIS=YES 




F 


F 


F 








R 






OLTEP=YES 




F 




RETAIN=YES 




F 


F 




PCIL=NO 








F 




RPS=YES 


F 


F 




F 




JALIOCSHs.l) 


R 






IDRA=YES 




R 




TRKHLD=n 


R 








ALLOCR 


R 





Figure 1-3. S0PERVISOR — Hacro Instructions Related Parameters 
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Code 


Actual IBM Device 


Device Type 
X'nn' 


Device Type 


7770 


7770 Audio Response Unit 


D3 


Audio Response Units 


2501 t 

2540 R 

3505 

3504 


2501 Card Reader 
2540 Card Reader 
3505 Card Reader 
3504 Card Reader 


10 
11 
12 
12 


Card Readers 


2540P 

2520B2 

1442N2 

2520B3 

3525P 


2540 Card Punch 
2520B2 Card Punch 
1442N2Card Punch 
2520B3 Card Punch 
3525 Card Punch 


21 
20 
22 
20 
23 


Card Punches 


1442N1 t 
2520B1 t 
2560 t 
2596 t 
3525RP 
5425 


1442N1 Card Read Punch 

2520B1 Card Read Punch 

2560 Multifunction Card Machine 

2596 Card Read Punch 

3525 Card Punch (with optional read feature) 

5425 Multifunction Card Unit 


30 
31 
33 
30 
32 
34 


Card Read Punches 


2311 t 
2314 t 
2314 t 
2321 f 
3330* t 
3330B* 

3340* t 
3340R * t 

3340 R* t 

3340 R t 
3340* t 

3340* t 

3350* 


231 1 Disk Storage Device 

2314 Direct Access Storage Facility 

2319 Disk Storage Facility 

2321 Data Cell Drive 

3330 Disk Storage Model 1 and 2, or 3333-1 

3330 Disk Storage Model 1 1 

3340 Disk Storage (General) 

3340 Disk Storage with RPS feature (with or without 

3340 Data Module, Model 35) 
3340 Disk Storage with RPS feature (with or without 

3340 Data Module, Model 70) 
3344 Direct Access Storage 
3340 Disk Storage without RPS feature (with or without 

3340 Data Module, Model 35) 
3340 Disk Storage without RPS feature (with or without 

3340 Data Module, Model 70) 
3350 Direct Access Storage 


60 
62 
62 
61 
63 
65 
6A 
69 

6A 

69 
6A 
67 


DASD 


3540 t 


3540 Diskette Input/Output Unit 


80 


Diskette Storage Device 


2955 


2955 Data Adapter Unit 


D7 


Data Link for RETAIN 


125D 
125DP 

3277 


Model 115 or Model 125 Integrated Display Operator Console 
Model 138/148 console in 115/125 console display 

emulation mode 
Model 115 or Model 125 Integrated Display Operator Console 

with 5213 Console printer attached 
3286-2 in display mode 

Note: Codes are valid for native Alpha-Numeric Replacement (ANRI 
mode and for 1052 emulation mode. The 1052 mode is not 
supported with Indirect Data Addressing (IDA). 

3277 Operator Console 


B2 
B2 

B0 


Display Operator Console 


2260 

3277 (Local 3270) 

3277B (Local 32701 


2260 Display Station 

3277 Display Station; MODE operand need not be entered 
3277 Display Station; attached in Burst Mode to a multi- 
plexer channel. MODE operand need not be entered 
Note: A 3277, in order to be used as a display operator console, must 
not be assigned to the same selector or multiplexer channel as SYSRES. 


CO 
B0 

B0 


Display Stations 


2400T9 t 
2400T7 t 


9-track Magnetic Tape Units 2400 - series 
7-track Magnetic Tape Units 2400 - series 


50 
50 


Magnetic Tape Devices 


Specify 231 1 if a 3330-1 is used with the 231 1-1 /3330 Series Compatibility Feature (8040). 

Specify 231 1 if a 3340 is used with the 231 1-1 /3340 Series Compatibility Feature (8060). 

Specify 2314 if a 3340 is used with the 2314/3340 Series Compatibility Feature (8070). 

Specify 3330 if a 3350 is used in 3330 compatibility mode. 

Specify 3330B if a 3350 is used in 3330-11 compatibility mode. 

f indicates burst-mode devices or overrunable devices that require specification of BMPX=YES in the PIO macro. 



Figure 1-4. S0PEBVISOB — Device Code for the DVCGEM Hacro Instruction (Part 1 of 2) 
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Code 


Actual IBM Device 


Device Type 
X'nn' 


Device Type 


3410T9 t 
3410T7 t 
3420T9 + 
3420T7 t 


9-track 3410 Magnetic Tape Units 
7-track 3410 Magnetic Tape Units 
9-track 3420 Magnetic Tape Units 
7-track 3420 Magnetic Tape Units 


53 
53 
52 
52 


Magnetic Tape Devices 


1419 + 
1419 + 
1419 + 
1419P + 
1419S + 


1255 Magnetic Character Reader 

1259 Magnetic Character Reader 

1419 Magnetic Character Reader 

1419 Dual Address Adapter Primary Control Unit 

1419 Dual Address Adapter Secondary Control Unit 


72 
72 
72 
73 
74 


MICR - Magnetic Ink Character Recognition Devices 


3895 


3895 Document Reader /I nscriber 


7D 


Reader /I nscriber 


1419 t 
1419P + 
1419S t 

1287 + 

1288 + 
3881 

3886 


1 270 Optical Reader Sorter 

1275 Optical Reader Sorter Primary Control Unit 

1275 Optical Reader Sorter Secondary Control Unit 

1287 Optical Reader 

1288 Optical Page Reader 
3881 Optical Mark Reader 
3886 Optical Character Reader 


72 
73 
74 
77 
77 
11 
7C 


Optical Readers 


1018 


1018 Paper Tape Punch with 2826 Control Unit Model 1 


79 


Paper Tape Punches 


1017 
2671 


1 01 7 Paper Tape Reader with 2826 Control Unit Model 1 
2671 Paper Tape Reader 


78 
70 


Paper Tape Readers 


PRT1 

1403 

1403U 

1443 

2245 

2260 (Local) 

3203 
3211 
3277 (Local 3270) 

3277B (Local 3270) + 

3800 
3800B 

3800C 

38O0BC 

5203 
5203U 


3211 or 3203-4 Printer 

1403 Printer 

1403 Printer with UCS feature 

1443 Printer 

2245 Kanji Printer 

1053 Printer with 2848 Control Unit, MODE operand 

must be entered as X'OV 
3203 Printer Model 1 and 2 
3211 or 3203 4 Printer 
3284 or 3286 Printer with 3272 Control Unit, MODE 

operand must be entered as X'OV 
3284 or 3286 Printer with 3272 Control Unit, attached in 

Burst Mode to a multiplexer channel. MODE operand 

must be entered as X'OV 
3800 Printing Subsystem 

3800 Printing Subsystem with optional Burster-Trimmer- 
Stacker 
3800 Printing Subsystem with additional character 

generation storage 
3800 Printing Subsystem with Burster-Trimmer-Stacker 

and additional character generation storage 
5203 Printer 
5203 Printer with UCS feature 


43 
40 
42 
41 
44 
CO 

4A 
43 
B0 

B0 

45 
45 

45 

45 

4C 
4D 


Printers 


1050 A* 


3210, 3215 Console Printer Keyboards 
3286-2 in printer keyboard mode 


00 


Printer Keyboard 


2495TC 


2495 Tape Cartridge Reader 


51 


Tape Cartridge Reader 


2701 
2701 

2701 k 
*D 

2703 
3705 
3791 L 


2701 /271 5 Data Adapter Unit 

Model 135 Integrated Communication Adapter (ICA) 

2702 Transmission Control Unit 

Model 1 15 or 125 Integrated Communication Adapter 
3704/3705 Communications Controller 
3791 Local Communications Controller 


DO 
DO 

D1 

D2 
DC 
DE 


Teleprocessing lines 

A'SADO command when enabling the line 
B-SAD1 command when enabling the tine 
C=SAD2 command when enabling the line 
D=SAD3 command when enabling the line 


2703 
2703 


3704/3705 Communications Controller in Emulation Mode 
2703 Transmission Control Unit 


02 
D2 




UNSP 

UNSPB + 


Unsupported Device 
Unsupported Device 


FF 
FF 


Unsupported no-burst mode on multiplexer channel 
Unsupported with burst mode on multiplexer channel 


*Note: Specify coda of 125Dor 125DPfor a Model 115 or Modal 125 Integrated Oitplay Operator Console in 1062 emulation mode. 
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Supervisor Real Storage Requirements 

This section contains the data for estimating the size of the supervisor required for a 
generated system,, that is, the amount of real storage needed at object time for tne 
supervisor macro instructions. 

The supervisor varies in size from system to system depending on the user-selected 
options and the machine configuration. All supervisor generation options are described 
earlier in this module under "The Supervisor Generation Macros". 

The size of the supervisor is a determining factor for the amount of real storage 
available for problem program use. All real storage not allocated to the supervisor is 
available for use by programs running in virtual mode (the main page pool) and in real 
mode via specification of real partitions. For more details on the allocation of real 
partitions refer to the description of the ALLOCR macro instruction. 

Figure 1-5 gives the real storage requirements for your supervisor, the size of which 
is determined by the options you specify (including default specifications) in the 
supervisor generation macro instructions. The basic supervisor (see sizes on the first 
line of data of Figure 1-5) is dependent on the number cf partitions you require (SUPVR 
macro NPARTS=); however, it is independent of any other supervisor generation options. 

To this basic size you must add the storage requirements for each selected option (see 
column "Generation Operand" in Figure 1-5). You must be careful to include the values 
for any options you have selected by default. 

You must also include the storage requirements for any option you did not specify but 
which is forced by another option you did specify (see Figure 1-3 showing which options 
are forced or required). Thus, for example, the SUPVR macro operand for Page Exception 
Handling Overlap (PHO=YES) forces the FOPT macro operand PFIX=YES for page fixing. 
Therefore, if you specify PHO=YES, you must include the storage requirements of both 
PHO=YES and PFIX=YES. 

The comments column of Figure 1-5 indicates when one option forces another option or 
is forced by another option. Certain options share common code and thus the mixture 
rather than the individual values must be considered in obtaining the total storage 
requirement. Thus, for example,, the FOPT macro options IT=YES, PC=YES, and OC=YES share 
common code. Figure 1-5 provides for this by stating storage requirements for each 
option separately and in all combinations. If you have selected more than one of these 
options, select the combined requirement from the row which includes your combination. 

The SEND macro instruction allows you to reserve additional storage for your 
supervisor. Refer to the description of the SEND macro instruction for further details. 

Because of storage protection, the supervisor must always end on a 2K storage 
boundary. Supervisor generation always causes the total generated supervisor size to be 
rounded up to the nearest 2K boundary. Thus, a calculated supervisor end address of, 
say, 31,120 bytes, is rounded to 32K (32,768 bytes) . 

Some supervisor macro instructions do not affect your storage requirements because 
they merely supply information to be placed in storage occupied by other irecro 
instructions. These macro instructions are not included in Figure 1-5. They are: 

STDJC (all operands except SPARM=YES) 

ALLOC 

ALLOCR 

DVCGEN 

ASSGN 

DPD 

6 2 DOS/VS System Generation 



In summary, to calculate the size of your supervisor, add the values as indicated in 
Figure 1-5 for: 

• your base (determined by NPARTS=) 

• The storage requirements for all options you specifically selected 

• The storage requirements for those options you did not specify but that default to YES 

• Storage requirements for all options you selected indirectly, that is options that 
were forced by other, specified, options 

• Any additional storage you reserved via the SEND macro instruction. 

• For any combination of options not explicitly shown in Figure 1-5, you should add up 
the individual values. 





Generation 


NPARTS=1 




Multiproj 


ramminq 




Comments 


Supervisor Element 


Operand 


NPARTS=2 


NPARTS=3 


NPARTS=4 


NPARTS=5 


SUPVR (Required Rout- 




23960 


29944 


30488 


31064 


31672 


Based on MODEL=115orMODEL=125 


ines — Basic Size) 
















SVC Interruption Handling 
















System Loader (FETCH and LOAD) 
















Minimum t/0 Units Control Tables 
















(LUBs, PUBs, andJIBs) 
















General Entry and Exit Routines 
















System Communication Region 
















Partition Communication Regions 
















Transient Areas 
















End of Job Stsp 
















Byte Multiplexer and Selector Channel Support 
















Storage Protection 
















CCW Translation 
















Page Management 
















231 1/2314 Disk Error Recovery 
















Optional Routines 
















Multitasking 


AP=YES 


NA 


4680 


4442 


4216 


4000 


1, Forces WAITM=YES 

2. Forces NPARTS=3 if NPARTS omitted 


ASCII/EBCDIC Translation Tables 


ASCII=YES 


512 


512 


512 


512 


512 


or specified as 1 


RMSRsupport for Channel-attached 


CHAN=YES 


960 


1024 


1024 


1024 


1024 


If RMS=YESor MCH-YES is also specified, add 


devices, tape units, or TP-devices used 














the value given for RMS instead. 


with a Model 115 or 126 
















Reliability Data Extractor Error 


ERRLOG=RDE 

















For Model M5or 125, CH AN=YES or RMS=VES 


Recording (IPL.EOD) 














is required 


14xx Emulators 


EU=YES 


216 


216 


216 


216 


216 




Supervisor Select 


ID = c 



















Model 115/125 MCAR/CCH support 


MCH = YES 


3968 


3968 


3968 


3968 


3968 


If RMS=YES or CHAN=YES is also specified, add 
the value given for RMS instead. 


Magnetic Ink Character Reader 


MICR = 1419 


1208 


1208 


1208 


1208 


1208 




Page Exception handling 


( for 1255/ 1259/1270/ 1275s 
see Note 1 ) 
















MICR = 1419D 


1080 


1080 


1080 


1080 


1080 






( Dual Address Adapter 
















1419/127E») 














Page Handling 


PAGE IN=n(nmustbe*1) 


1408 + 
8n 


1592+ 
8n 


1592 + 
8n 


1592+ 
8n 


1592 + 
8n 




Page Exception Handling Overlap 


PH0 = YES 


592 


640 


656 


680 


696 


Forces PFIX=YES; Forced by P0WER=YES 


POWER/VS 


POWER = YES 


NA 


546 


546 


546 


546 


Forces NPARTS=3, if NPARTS omitted 
or specified as 1; also forces PH0=YES, 
PFIX=YES, and ECPREAL=YES 


RMS support ( RMSR plus MCA/CCH ) 


RMS=YES or CHAN=YES and 


4864 


4928 


4928 


4928 


4928 


Do not include any values for CHAN=YES 


for Model 115 and 125 


MCH=YES 












and for MCH=YES 


Teleprocessing 


TP=BTAM 


544 


872 


872 


872 


872 


TP=QTAM or VTAM forces NPARTS=3 


(see Note 2) 


TP=QTAM 


NA 


1400 


1400 


1400 


1400 


if NPARTS is omitted or specified as 1 




TP=QTAMn 


NA 


1352 


1352 


1352 


1352 


















TP=VTAM forces AB=YES, ECPREAL-YES. 




TP=VTAM 


NA 


3020 


3012 


3004 


2996 


GETVIS=YES, IT'YES, 0C=YES. PC=YES, 




TP=(BTAM,VTAM> 


NA 


3020 


3012 


3004 


2996 


PFIX-YES, RELLDR=YES, RMS=YES in the 




TP=(QTAM,VTAM) 


NA 


3580 


3572 


3564 


3556 


case of Models 1 15 and 125, and TOD=YES. 




TP=(QTAMn,VTAM| 


NA 


3532 


3524 


.3516 


3508 


AP=YES is required. 
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Supervisor Element 


Generation Operand 


Multiprogramming 




NPARTS=1 


NPARTS=2 


NPARTS=3 


NPARTS=4 


NPARTS=5 


CONFG 












• 




(Configuration Options) 
















Floating Point Feature 


FP=YES 





72 


72 


72 


72 




Model 115 
Model 125 


MODEL=115 
MODEL=125 


/ Log out area = 






"^ 


Model 1 35 
Model 138 


MODEL=135 
MODEL=138 


? Log out area = 120 






I Forces RMS support (see 


Model 145 
Model 148 


MODEL=145 
MODEL=148 


> Log out area = 672 






[ RMS=YES in SUPVR macro) 


Model 155-11 
Model 1 58 


MODEL=155-ll 
MODEL=158 


f Log out area = 992 






J 


STDJC 














(Standard Job Control 
















Settings) 
















Support of &SYSPARM 


SPARM-YES 


8 


16 


24 


32 


40 


other STDJC options require no storage 


Assembler System 
















Variable Symbol 
















FOPT 














(Functional Supervisor 
















Options) 
















Abnormal Termination 


AB=YES 

without AP=YES 


288 


296 


304 


312 


320 


Forced by VSAM=YES 




with AP=YES 


NA 


384 


384 


384 


384 




Console Buffering 


CBF=n (see Note 5) 




240 + 104n 






Does not apply to Models 115 and 125, 
138, 148 


DASO 


DASDFP={n1,n2) 




336+24(n2-n1) 








File 


for 2311/2314 












Protection 


DASDFP=(n1,n2) 
for 2311/2314, 33xx 

DASDFP={n1,n2,2321) 
for 231 1/231 4, 
33xx, 2321 




400 + 24(n2-n1) 
464 + 24(n2-n1) 








Display 
Operator 


DOC=125D 
DOC=3277 


3392 
4864 


3392 
4864 


3392 
4864 


3392 
4864 


3392 
4864 




Console 
















Error Queuing 


ERRQ=n 


44(n-3) 


44(n-5) 


44<n-5) 


44(n-5) 


44(n-5) 


if default used 


Error Volume Analysis 


EVA=(r,w) 

















Forces TAPE=7 


Fast CCW 
translation 


FASTTR=YES 
FASTTR=YES 
when AP=YES 


2120 

NA 


1992 
2296 


2024 
2296 


2048 
2296 


2080 
2296 


Does not include buffer space 
(seeBUFSIZE) 


Virtual Storage 
Management Support 


GETVIS=YES 


1126 


1318 


1318 


1318 


1318 


Forced by VSAM=YES, and RPS=YES 
Forces RELLDR=YES 


Independent Directory 
Read/In Area 


IDRA=YES 


NA 


200 


200 


200 


200 


Valid only if NPARTS>1 (Add 768 byte 
if RELLDR=YES) 


Interval Timer 


IT=YES 


432 


880 


888 


912 


920 


If OC=YES, refer to OC, if PC=YES, 
refer to PC 


Job Accounting 


JA=YES 


488 


672 


808 


944 


1080 




Interface 


JA=(n1,n2,n3,n4,n5) 


576 + 
8(n1> 


760 + 

8(n1+n2) 


896 + 
8(n1+n2+n3) 


1032 + 

8(n1+n2+ 
n3+n4) 


1168 + 

8(n1+n2+ 

n3+n4+n5) 






JALIOCS=(s,l) 




Value from JA plus 


(s + l) - 16 








(see Note 3) 
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Supervisor Element 


Generation Operand 


NPARTS=1 


Multiprogramming 


Comments 


NPARTS=2 


NPARTS=3 


NPARTS=4 


NPARTS=5 


FOPT (continued) 
















User Channel Program 


ECPREAL=YES 


320 


320 


320 


320 


320 


Forces PF I X=YES; 


Translation 














Forced by POWER=YES 


Problem Program Handling 


OC=YES 


280 


288 


296 


304 


312 


Forced by RETAIN=YES 


of External Interruptions 














andOLTEP=YES 




Including IT=YES 


572 


968 


984 


1016 


1032 






Including IT=YES when 


NA 


1232 


1240 


1248 


1256 


Does not include any AP storage 




AP=YES 












requirements 




Including IT=YES and 


560 


1016 


1040 


1064 


1088 






PC=YES 
















Including IT=YES and 


NA 


1408 


1416 


1424 


1432 


Does not include any AP storage 




PC=YESwhen AP=YES 












requirements 


Online Testing 


OLTEP=YES (default) 


248 


256 


256 


256 


256 


Forces RELLDR=YES and OC=YES 
Forced by RETAIN-YES 


Support of User Program 


PC=YES 


248 


264 


272 


280 


288 




Check Routines 


















when AP=YES 


NA 


384 


384 


384 


384 


Does not include any AP storage 
requirements 




Including IT=YES 


480 


944 


952 


992 


1008 






Including OC=YES 


328 


352 


368 


384 


400 






Including IT=YES when 


NA 


1312 


1312 


1312 


1312 


Does not include any AP storage 




AP=YES 












requirements 




Including IT=YES and 


NA 


1408 


1416 


1424 


1432 


Does not include any AP storage 




OC=YESwhen AP=YES 












requirements 


Private Core Image Library 


PCI L= YES 


192 


224 


240 


264 


280 




Support 
















Problem Determination 


PD=n 


n + 160 


n + 200 


n + 200 


n +200 


n + 200 




Program (PDAIDS) 


















PD=YES 


1560 


1600 


1600 


1600 


1600 




Page fixing 


PFIX=YES 


1776 


1928 


1928 


1928 


1928 


Forced by PHO=YES, ECPREAL-YES 














and P0WER=YES 




PFIX=YESand FASTTR=YES 


1984 


2136 


2136 


2136 


2136 




Partition Dispatching 


PRTY=partition name and sequence 


NA 
















Priority 
















Private Second 


PSLD=n 


8n 


16n 


24n 


32n 


40n 




Level Directories 
















Relocating Loader 


RELLDR=YES 


448 


448 


448 


448 


448 


Forced by GETVfS=YES, OLTEP^YES, 
VSAM=YES, and RPS--YES 








112 


112 


112 


112 


Forces 0C=YES and 0LTEP=YES 


RETAIN-Remote Initiation 


RETAIN=YES 


112 






of OLTEP programs 
















Rotational 


RPS=YES 


NA 


600 


600 


600 


600 


Forces GETVIS=YES, 

RELLDR -YES, and BLKMPX=YES 


Position Sensing 
















Seek Separation 


SKSEP=YES, or n (see Note 4) 


150 + 5n 


150 + 5n 


150 + 5n 


150 + 5n 


150 + 5n 




Second Level Directory 


SLD=n 


8n 


8n 


8n 


8n 


8n 




Disk System Input and 


SYSFIL=YESorYES(n1,n2) 


704 


720 


876 


962 


1048 




Output Files 


and DASDFP=NO 
















andDASDFP=(k1,k2,2321) 


1088 + 24(k 


2-k1)+86(N 


PARTS-1) 










and DASDFP=(k1,k2) 


960 + 24(k2 


-k1) +86(NP 


ARTS-1) 










and DISK=(231 1,2314) 
















and DASDFP=(k1,k2) 


1040 + 24(k 


2~k1) +86(N 


PARTS-1) 










and DISKH231 1,2314,33xx) 
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Supervisor Element 


Generation 




Multiprogramming 


Comments 




Operand 


NPARTS=1 


NPARTS=2 


NPARTS=3 


NPARTS=4 


NPARTS=5 






FOPT (Cont.) 


















Tape Error Statistics — 


TEB=n 


36+6n 


36+6n 


36+6n 


36+6n 


36+6n 






2495 Tape Cartridge 


















Reader 


















Tape Error Statistics 


TEBV=IR, orCR 





















by Volume 


















Time-of-Day Clock 


TOD=YES 


640 


640 


640 


640 


640 






Support 


















Track Hold 


TRKHLD=n 


NA 


464+ 


464+ 


464+ 


464+ 


Valid only if NPARTS>1 






(see Note 6) 




12n 


12n 


12n 


12n 






Supervisor identification 


USERID=id 

















Included in basic size whether id is specified 


or not. 


VSAM 


VSAM=YES 
(incl.NRES=10) 


1752 


984 


984 


984 


984 


Forces AB=YES, GETVIS=YES, NRES=10, 
and RELLDR=YES 




Multiple Wait 


WAITM=YES 


56 


56 


56 


56 


56 


Forced by AP=YES 




Cross- partition 


XECB=YES 


NA 


884 


948 


1012 


1076 






Communication 


XECB=n 


NA 


756+1 6n 


756+1 6n 


756+16n 


756+1 6n 






Time Zone for Time of 


ZONE=NO ' 
















Day Clock Support 


<EAST,hh,mm) 
<WEST,hh,mm) 





















Task Timer 


TTIME=YES 
and AP=NO 


390 


390 


390 


390 


390 








TTIME=YES 


400 


400 


400 


400 


400 








and AP=YES 
















Synchronous Exit 


SYNCH=YES 


252 


252 


252 


252 


252 


Forced by RPS=YES 




PIOCS 


BLKMPX=YES 


32 


32 


32 


32 


32 


(Physical IOCS Support) 


















Burst Mode on Byte 


BMPX=YES 


80 


80 


80 


80 


80 






Multiplexer Channel 


















Channel Switching Tape 


CHANSW=RWTAU 


224 


224 


224 


224 


224 


Forces TAPE=7 




Control 


or TSWTCH 


















DISK=2311,or2314 

















Not valid if MODEL=1 15 or 125 






DISK=3330 


768 


768 


768 


768 


768 


Forced for Model 125 






DISK=3340 


1344 


1344 


1344 


1344 


1344 


Forced for Model 1 1 5 






DISK=3350 


832 


832 


832 


832 


832 


Not valid if MODEL=1 1 5 or 1 25 






DISK=(3330, 


1600 


1600 


1600 


1600 


1600 








3340) 


















DISK=(3330, 


896 


896 


896 


896 


896 








3350) 


















DISK=(3340, 


1600 


1600 


1600 


1600 


1600 








3350) 


















DISKH3330, 


1664 


1664 


1664 


1664 


1664 








3340, 


















3350) 
















MICR Device on Selector 


MRSLCH=YES 


32 


32 


32 


32 


32 






Channal (1419 Single 


















Address,Device only) 














TAPE=7 is forced by EVA=(r,w) and 




Tape Support 


TAPE=7, 

or 9 (default) 


584 


584 


584 


584 


584 


by CHANSW=RWTAU or TSWTCH. For Model 115 
or 125 CHAN=YES is required. 


VSTAB 




Obtain value from table - 


This is fo 
NPARTS 




(Size of Real and Vir- 
tual Address Areas and 
CCW Translation 


RSIZE^K — | 


Part 5 of this Figure. 
_„ When PHO=YES or 

PFIX=YES, addy-, and 


r: 

=1 652 
2 788 






space) 


VSIZE=n 2 K —J 




3 856 








(See Note 8) 


subtract the number of bytes 




4 924 








BUFSIZE=n 


included in basic supervisor. 




5 992 








(Required) 




















72(n-10) 


72<n-30) 


72(n-30) 


72(n-30) 


72(n-30) 


if default used (for FASTTR-NO). 
If FASTTR=YES, substitute for 'n' 






SVA=(rtk,mk) 

















the specified or default value. 
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2 

O 
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0) 
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Cb 
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n 

<n 

fD 

w 

fD 

H- 
H 
fD 

CD 

rf 
en 



bd 
rt 

fD 
M 



O 

Hi 

















RSIZE (K bytes) 












VSIZE 


64 


96 


128 


144 


160 


192 


208 240 


256 


384 


512 


768 


1024 


(K bytes) 
64 


























456 





_ 


_ 


_ 


_ 


_ _ 


_ 


_ 


_ 


_ 


_ 


96 


524 


652 


- 


- 


- 


- 


- - 


- 


- 


- 


- 


- 


128 


524 


720 


848 


- 


- 


- 


- - 


- 


- 


- 


- 


- 


192 


592 


788 


916 


1048 


1112 


1240 


- 


- 


- 


- 


- 


- 


256 


660 


856 


984 


1116 


1180 


1308 


1440 1568 


1632 


- 


- 


- 


- 


320 


72E 


924 


1052 


1184 


1248 


1376 


1508 1636 


1700 


- 


- 


- 


- 


384 


796 


992 


1120 


1252 


1316 


1444 


1576 1704 


1768 


2416 


- 


- 


- 


448 


864 


1060 


1188 


1320 


1384 


1512 


1644 1772 


1836 


2484 


- 


- 


- 


512 


932 


1128 


1256 


1388 


1452 


1580 


1712 1840 


1904 


2552 


3348 


- 


- 


640 


1068 


1264 


1392 


1524 


1576 


1716 


1848 1976 


2040 


2688 


3548 


- 


- 


704 


1136 


1332 


1460 


1592 


1656 


1784 


1916 2044 


2108 


2820 


3616 


- 


- 


768 


1204 


1400 


1528 


1660 


1724 


1852 


1984 2112 


2176 


2888 


3684 


4980 


- 


832 


1272 


1468 


1596 


1728 


1792 


1920 


2116 2244 


2308 


2956 


3752 


5048 


- 


896 


1340 


1536 


1664 


1860 


1924 


2052 


2184 2312 


2376 


3024 


3820 


5116 


- 


960 


1408 


1668 


1796 


1928 


1992 


2120 


2252 2380 


2444 


3092 


3888 


5184 


- 


1024 


1540 


1736 


1864 


1996 


2060 


2188 


2320 2448 


2512 


3160 


3956 


5252 


6548 


1280 


1812 


2008 


2136 


2268 


2332 


2460 


2592 2720 


2784 


3432 


4228 


5524 


6884 


1536 


2084 


2280 


2408 


2540 


2604 


2732 


2864 2992 


3056 


3704 


4500 


5860 


7156 


1792 


2356 


2552 


2680 


2812 


2876 


3004 


3136 3264 


3328 


4040 


4836 


6132 


7428 


2048 


2692 


2888 


3016 


3148 


3212 


3340 


3472 3600 


3664 


4312 


5108 


6404 


7700 


2304 


2964 


3160 


3288 


3420 


3484 


3612 


3744 3872 


3936 


4584 


5380 


6676 


8036 


2560 


3236 


3432 


3560 


3692 


3756 


3884 


4016 4144 


4208 


4856 


5652 


7012 


8308 


2816 


3508 


3704 


3832 


3964 


4028 


4156 


4288 4416 


4480 


5192 


5988 


7284 


8580 


3072 


3844 


4040 


4168 


4300 


4364 


4492 


4624 4752 


4816 


5464 


6260 


7556 


8852 


4096 


4996 


5192 


5320 


5452 


5516 


5644 


5776 5904 


5968 


6616 


7412 


8708 


10004 


5120 


6148 


6344 


6472 


6604 


6668 


6796 


6928 7056 


7120 


7768 


8564 


9860 


11156 


6144 


7300 


7496 


7624 


7756 


7820 


7948 


8080 8208 


8272 


8920 


0716 


11012 


12308 


7178 


8520 


8648 


8844 


8908 


8972 


9168 


9232 9360 


9492 


10140 


10936 


12232 


13592 


8192 


9604 


9800 


9928 


10060 


10124 


10252 


10384 10512 


10576 


11224 


12020 


13316 


14612 


9216 


10756 


10952 


11080 


11212 


11276 


11404 


11536 11664 


11728 


12376 


13172 


14468 


15764 


10240 


11908 


12104 


12232 


12364 


12428 


12556 


12688 12816 


12880 


13528 


15620 


15620 


16916 


11264 


13060 


13256 


13384 


13516 


13580 


13708 


13840 13968 


14032 


14680 


15476 


16772 


18068 


12288 


14212 


14408 


14536 


14668 


14732 


14860 


14992 15120 


15184 


15832 


16628 


17924 


19220 


13312 


15364 


15560 


15688 


15820 


15884 


16012 


16144 16272 


16336 


16984 


17780 


19076 


20372 


14336 


16516 


16712 


16840 


16972 


17036 


17164 


17296 17424 


17488 


18136 


18932 


20228 


21524 


15360 


17668 


17864 


17992 


18124 


18188 


18316 


18448 18576 


18640 


19288 


20084 


21380 


22676 


16384 


18820 


19016 


19144 


19276 


19340 


19468 


19600 19728 


19792 


20440 


21236 


22532 


23828 

■ 



Page of GC3 3-5377-6, Revised November 28, 1977, By TNL GN33-9230 





Generation 
Operand 


NPARTS=1 


Multiprogramming 


Comments 


Supervisor Element 


NPARTS=2 


NPARTS=3 


NPARTS=4 


NPARTS=z5 


IOTAB 
















(Input/Output Tables) 
















Number of programmer 


8GPGR=n 


2(n-10) 


2(o-10) 


2<n-10) 


2(n-10) 


2(n-10> 


\ 


logical units 


F4PGR=n 
F3PGR=n 








2(n~5> 


2<n-5> 
2(n-5) 


/ 




F2PGR=n 






2(n-5) 


2(n-5) 


2|n-5) 


>0 if default used 




F1PGR=n 




2(n-5) 


2(n-5) 


2(n-5) 


2(n-5) 


I 


Number of Channel 
Queue Entries 


CHANQ=n 
(see Note 5) 


8(n-6) 


8(n-6) 


8(n-6) 


8(n-8) 


8(n-10) 


' 


Amount of Extra Space 


D2311=n, 






24n, 




\ 


reserved tor the PUB 


02314=Oj 






24n, 




■For Models 1 15 or 125, 


Table (required for 


02321=nj 






24n, 




f these parameters are ignored if both 


RMSR recording) 


D3330=n 4 

D3340=n 5 

D3350=o 6 

03400=o 7 

O3410=o 8 

D3420=n, 

D3540=o, 

D3800»n M 

D3836=n„ 






32n 4 

16n, 

32n 6 

76n, 

84n, 

84n, 

16n 10 

96n„ 

26n„ 




[ CHAN=NO and RMS=N0 in tha SUPVR 
V macro, or if both these parameters 
/are omitted and, therefore, default 
I to NO. 




(see Note 7) 














Number of I/O 
devices on system 














For Models 1 1 5 and 1 25 without 
CHAN or RMS. if default used 
for Model 135 and upward and 
for Model 1 1 5 or 1 25 with CHAN 




■ 10(n- 














1 20 + 2 






















or RMS. 


Number of Job Inform- 


JIB=rN 


4<n-5> 


4<n-5) 


4{n-5J 


4(n-6) 


4<n-5> 




ation Blocks 
















Number of Start/Stop 


SSLNS=n1, 




4 + 4(n,-4 


+ 4(n 2 -n 








Lines and Nu r\bf of 


BSCLNS = n2 




1 




■ " "t> 




BSC Lines (Model 11b 


(when TP = BTAM. 














and Model 125 ICA Only) 


or QTAM) 














Number of Named 
Resources in the System 








12n .. 






NRES-10 is included in 
VSAM if VSAM-YES. but 


NRES = n 


























NRES is not specified. 



Figure 1-5. Supervisor Real Storage Requirements — Bytes (Part 6 of 6) 



Notes : 



A 1255/1259/1270 
MICR=1<*19. 



is addressed as a single address adapter machine,, that is. 



NPARTSM is required for TP=QTAMn. TP=QTAMn includes BTAM supervisor support, if 
AP=YEf> when TP=QTAMn, then the quantity A must be added to the basic storage 
requirement for TP=QTAMn. A=4U+(n-2) 12, where n is the value elected for TP=QTAMn. 

(For multitasking, AP must equal ¥ES.) 

If s is omitted or if its specification is invalid, then 16 bytes are reserved. If 
is omitted or if it is invalid, is assumed. 

When SKSEP=YES, n (in the formula) equals the number of DASD devices specified at 
system generation time. When SKSEP=n, n (in the formula) is the number of DASD 
devices supported as specified,, but cannot be less than the number specified at 
system generation time. 
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5. The selection of the CBP option results in extra channel queue usage. Consider this 
when requesting the number of CHANQ entries. Thus, specification of the CBF option 
and selection of the CHANC default, results in the nuirber of buffers specified being 
added to the CHANQ default, for which see below. 

CHANQ default = 6 if NPARTS=3 
CHANQ default = 8 if NPARTS=4 
CHANQ default = 10 if NPARTS=5 

Only if the number of queue entries as specified by the CBF parameter plus the chanq 
default is larger than the number of entries actually specified by the CHANQ 
parameter, add 8n a , where n 3 =CHANQ default ♦ CBF specification - CHANQ specification 
(zero for negative)*. 

Example 1: CHANQ=30 
CBF=4 
NPARTS=4 (CHANQ default is 8) 

Number of bytes reserved for CBF: 240+104x4+8x0 (n 2 =0 because CBF(4)+chanq default (8) 
is less than 30 (CHANQ specification). 

Example 2: CHANQ=10 
CBF=4 
NPARTS=4 (CHANQ default is 8) 

Number of bytes reserved for CBF: 240+104x4+8x2 (n a =2 because CBF( 4) +CHANQ default (8) 
minus CHANQ (10) =2). 

6. Where n equals the maximum number of tracks (1-255) tc be held at any given time by 
the entire system. The default is 10 if n is an invalid parameter (non-numeric or 
outside the range, 1-255). 

7. In addition to the total number of bytes reserved for the devices specified, an 
extra amount is reserved of 12B bytes, where B equals the number of devices 
specified by the IODEV parameter minus the total number of devices specified by the 
Oxxxx parameters. (B=n-(n, +n 2 +n 3 +n 4 +n s +n 6 +n 7 +n 8 +n 9 + n 10 + n M + n n ). 

The minimum value of B is 5, because of the fact that if the total nuirber of devices 
specified by the Dxxxx parameters exceeds the number of devices specified by the 
IODEV parameter, the latter number is upgraded to 5 more (for unit record devices) 
than the number of devices specified by the Dxxxx parameters. 

8. Since the table (Part 5 of this figure) does not contain all possible VSIZE values, 
you say use the nearest larger value without significant error. The. exact formula 
for calculating real storage requirements is as follows, where n1=ESIZE specification 
and n2*VSIZE specification, both in K bytes. 

4 x n1 ♦ 68 x CEIL ♦ 64 x CEIL ♦ value 

If n1>384, "value" equals 148 # otherwise "value 1 * equals 0. 
For CEIL substitute the quotient of 

°1 ♦ o2 ; fractions are to be rounded off to the next higher integer. 
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Computing the Size of a Supervisor 



As an example,, assume a supervisor is generated using the macros shown 
in Figure 1-6. The size of this supervisor is determined as follows: 

GENERATION OPERAND REAL STORAGE 

REQUIREMENT (bytes) 

SUPVR 

NPARTS=4 , 29 , 056 

P0WER=YES 462 

PHO=YES 680 

TP=BTAM, ■. ■ 872 

CONFG 

MODEL=135, . . 5, 072 

FP=YES 72 

STDJC 

FOPT 

RELLDR=YES 448 

VSAM=YES. 984 

IT=YES 

OC=YES . 1,096 

PC=YES 

SKSEP=YES 160 

PCIL=YES. .. , . 264 

PFIX=YES 1,928 

CBF=10 1,280 

TRKHLD=10,..- 584 

SYSFIL=YES 

DASDFP=(1„ 1,3330) 1,2 96 

TOD=YES , ■ 640 

ZONE=(WEST,5) 

GETVIS=YES . - 1,144 

OLTEP=YES 256 

AB=YES - 448 

ECPREAL=YES 320 

PIOCS 

DISK=3330 760 

TAPE=7 „ , .. . 584 

VSTAB 

RSIZE=24 0K, ,. 1,2 40 

VSIZE=702K 

BUFSIZE=48 1,296 

SVA=(302K,0K) 

ALLOC 

ALLOCR 

IOTAB 

BGPGR=20 20 

F1PGR=10 10 

F2PGR=10 10 

. F3PGR=10 , 10 

| IODEV=15. . 158 

JIB=45 160 

ID3330=2 64 
D3410=4 336 

CHANQ=32 19 2 

NRES=10 (included in VSAW) 



I 



Total Number of Eytes 51,902 

Note : If entry for BGPGR is below minimum requirement, n=10 is assumed. The following 
MNOTE is obtained for an entry of less than 10. 

BGPGR SPECIFICATION BELOW MINIMUM - "10" ASSUMED 
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// JOB SUPVR 

// OPTION DECK 

// EXEC ASSEMBLY) sfie H t belo| , 

MACRO f 

GENSUPVR 

SUPVR NPARTS=4, POWER=YES f PHO=YES„TP=ETAM 

CONFG MODEL=135,FP=YES 

STD JC LI STX= YES , LI NES=4 6 , EDECK=YES 

FOPT RELLDR=YES,IT=YES,VSAM=YES,OC=YES,PC=YES, 

SKSEP=YES,PCIL=YES„CBF=10,TRKHLD=10,SYSFIL=YES, 

DASDFP=(1,3, 3330),TOD=YES,ZONE=<WEST,5) ,PFIX=YES, 

AB=YES,OLTEP=YES,ECPREAL=YES 
PIOCS DISK=3 330,TAPE=7 

VSTAB RSIZE=24uK,VSIZE=702K,BUFSIZE=48, SVA= (302K # 0K) 
ALLOC F1=128K,F2=64K,F3=128K 
ALLOCR BGR-60K,F1R=30K,F2R=30K 
IOTAB BGFGR=2 0,F1PGR=10,F2PGR=1Q,F3PGR=10,IODEV=15,JIB=45, 

CHANQ=3 2,D3330=2,D3U10=4,NRES=10 
DVCGEN CHUN=X'00C* DVCTYP=25l*0R 



END 
/* 



DVCGEN CHUN=X'00D'' 
DVCGEN CHUN=X'00E'' 
DVCGEN CHUN=X'01F' 
DVCGEN CHUN=X'020' 
DVCGEN CHUN=X'0 21' 
DVCGEN CHUN=X'022' 
DVCGEN CHUN=X'0 23' 
DVCGEN CHUN=X'024' 
DVCGEN CHUN=X'160" 
DVCGEN CHUN=X'161' 
DVCGEN CHUN=X'280 t 
DVCGEN CHUN=X'281' 
DVCGEN CHUN=X'28 2* 
DVCGEN CHUN=X'28 3* 
ASSGN SYSRDR,X'00C 
ASSGN SYSIPT,X'00C 
ASSGN SYSPCH,X*00D 
ASSGN SYSLS1,X'00E 
ASSGN SYSLOG,X'01F 
ASSGN SYSLNK„X'160 
ASSGN SYS001,X*160 
ASSGN SYS0 02,X'160 
ASSGN SYS003,X'160 
ASSGN SYSREC,X'160 
ASSGN SYSCAT,X*161 
DPD CYI=200 f UNIT=X 
SEND 
MEND 
GENSUPVR 



DVCTYP=2 5M0P 

DVCTYP=3211 

DVCTYP=1050A 

DVCTYP=2703 

DVCTYP=2703 

DVCTYP=2703 

DVCTYP=2703 

DVCTYP=2703 

DVCTYP=3 330 

DVCTYP=3330 

DVCTYP=3410T7 

DVCTYP=3U10T7 

DVCTYP=3410T9 

DVCTYP=3 410T9 



160' ,VOLID=SYSRES 



I see Note, below 



Note: For MACHO, GENSUPVR, and MEND, refer to "Automatic Documentation of Supervisor 
Generation Macros". 

Figure 1-6. SUPERVISOR — Example for Computing the Size of a Supervisor 



Planning an Operational Pack 

An operational system is one used in day-to-day operations and contains one or more 
tailored supervisors, and libraries appropriate to each customer's particular combination 
of system programs and application programs. A system maintenance volume is one used 
primarily to facilitate changes to programs supplied by IBM. Application programs can 
also be added to a maintenance volume for ease cf program maintenance. Change 
Distributions are those changes supplied by IBM to the IB^.-shipped volume. 



Module 1: Planning and Procedures 71 



Proper planning is the key to successful system generations. The tiire spent in 
planning can save you frustration and valuable time. Planning should reflect the 
initial, intermediate and ultimate capacity of the core image, relocatable, source 
statement, and procedure libraries. Enough work file capacity must be available 
throughout system generation for assemblies and link- edit steps. 

The module for each component should be used to deteririne its storage requirements. 
Figure 1-18 contains a summary of the library and partition requirements for all 
components shipped with DOS/VS. Adjust the requirements you derived from this figure for 
any program products (separately purchased components) you are including. Please also 
note that any licensed programs supplied in A-macro format must be edited. 

The IBM-supplied system contains seven preassembled and cataloged supervisors for the 
2314/2319, 3330, 3340, and 3350 resident systems. The supervisor $$A$SUP1 is described 
in "Supervisor Nucleus — 5745-SC-SUP". 

S TORAGE REQUIREMENTS FOR IBM-SUPPLIED DOS/VS PROGRAMS 

Note that the partition save area is located at the beginning of each partition, thus 
reducing the partition size by the length of the save area. 

Organization of a DOS/VS System Pack 

The organization of the system pack is as follows: 



Name 

I PL Program 

System Volume Label 

System Directory 

Core Image Directory 

Core Image Library 

Relocatable Directory, Optional 

Relocatable Library, Optional 



Source Statement Directory, 
Optional 

Source Statement Library, 
Optional 

Procedure Directory, Optional 



Procedure Library, Optional 



Label Information Cylinder(s) 



St art of Location 

Track of cylinder 0. 

Track of cylinder 0. 

Track 1 of cylinder 0. 

Track 2 of cylinder 0. 

Beginning of the first available track following the 
core image directory. 

Track of the first available cylinder following the 
core image library. 

Beginning of the first available track following the 
relocatable directory. 

Track of the first available cylinder following 
the previous library. 

Beginning of the first available track following the 
source statement directory. 

Track of the first available cylinder following the 
previous library. 

Beginning of the first available track following the 
procedure directory. 

First full cylinder (plus a second cylinder for the 
3340) after the last system library. 
Figure 1-7 shows the DOS/VS concept of label track 
allocation, using the 2314/2319 as an example. 



Volume Table of Contents 



Location assigned by the user. 
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Note ; The IPL procedure cannot be performed if part of the Supervisor Nucleus in the 
core image library is located on an alternate track. 



Track 



t 1 

Background User 

Labels 



»~ + 



Background User 
Labels 



■+- 



Background User 
Labels 



Background User 
Labels 



Background Par- 
tition Standard 
(PARSTD) Labels 



Background Par- 
tition Standard 
(PARSTD) Labels 



Background Par- 
tition Standard 
(PARSTD) Labels 



Background Par- 
tition Standard 
(PARSTD) Labels 



H-+ 



Foreground 1 
User Labels 



Foreground 2 
User Labels 



Foreground 3 
User Labels 



Foreground 4 
User Labels 



H- + 



-+- 



Foreground 1 
Partition Stan- 
dard Labels 



I— + 



Foreground 2 
Partition Stan- 
dard Labels 



Foreground 3 
Partition Stan- 
dard Labels 



Foreground 4 
Partition Stan- 
dard Labels 



-+- 



-+- 



Standard 
Labels 



10 



19 

L L 



Foreground 1 
User Labels 



Foreground 2 
User Labels 



Foreground 3 
User Labels 



Foreground 1 
Partition Stan- 
dard Labels 



Foreground 2 
Partition Stan- 
dard Labels 



Foreground 3 
Partition Stan- 
dard Labels 



T- 



Foreg round 1 
User Labels 



Foreground 2 
User Labels 



Foreground 1 
Partition Stan- 
dard Labels 



-+- 



Foreground 2 
Partition Stan- 
dard Labels 



-+- 



Foreground 1 
User Labels 



Standard 
Labels 



Foreground 1 
Partition Stan- 
dard Labels 



Standard 
Labels 



Standard 
Labels 



2-Partition 
Systeir 



3-Partition 

System 



4-Partiticn 

System 



5-Partition 
System 



Figure 1-7. Label Cylinder Track Allocations for 2314/2319 Disk-Resident Systems 

Allocating Library Sizes 



When the size of an existing library is reduced, it may ce important to know the minimum 
size library that can be allocated. Once the minimum size library is calculated, it 
should be increased to accommodate any problem programs tc be included in the library. 
The size of IEM components can be determined by referring to the storage requirements 
given in Figure 1-18 and to appropriate documentation for any licensed programs to be 
included. 
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The following explanation illustrates how to calculate the number of tracks required 
for a core image, relocatable, source statement, or procedure library. The formula fcr 
computing the size of a library is: 

Library (size in tracks) = LBA/nn 

where: 

library = either core image relocatable, source statement, or procedure 

LBA = the number of LIBRARY BLOCKS ACTIVE for the library of interest and is obtained 

from a DIRECTORY (SYSTEM or PRIVATE) 
nn = LIBRARY LAST AVAILABLE ENTRY in the R (record) column. 

Using the sample STATUS REPORT that follows, an example of how to compute a library size 
is: 

Relocatable Library = LBA/nn 

where: 

LBA = 11,9 57 
nn = 16, thus Relocatable Library = 11, 957 = 747.5 tracks 

16 

The relocatable library size computed does not include the tracks allocated for the 
directory. The directory size must be added to the relocatable library size computed. 
Thus, 

Relocatable Library Allocation = Relocatable Library + Directory Allocated Tracks 

Therefore, 

Relocatable Library Allocation - 747.5+10 

= 757. 5 Tracks 

To find the number of required cylinders, divide the number of required tracks by the 
number of tracks per cylinder. 

For this example, 

the Relocatable Library Allocation for a 3330 = 757.5 Tracks 

19 
= 39.9 or 40 cylinders, rounded high 



STATUS REPORT 



STARTING 
ADDRESS 
C H R 



DATE: 10/28/76 TIME: 14.44 

NEXT LAST DIRECTORY LIBRARY BLOCKS COND. DIR. TRACKS 

ENTRY ENTRY ENTRIES LIMIT OR LIBRARY 

CHRE CHRE ACTIVE ALLOCTD ACTIVE DELETD AVAIL BLOCKS CYLINDERS 



SYSRES VOL.SER.R29RES 
CORE IMAGE DIRECTORY 
LIBRARY 



000 02 01 000 10 04 000 11 17 
000 12 01 043 18 06 054 19 06 



1402 



6528 5201 



1327 



10 
55 



SYSRES VOL.SER.R29RES 
RELOCATABLE DIRECTORY 
LIBRARY 



055 00 01 055 04 07 02 055 09 17 19 1477 
055 10 01 092 17 06 096 19 16 



13280 11957 



1323 



10 
42 



SYSRES VOL.SER.R29RES 
SOURCE-STMT DIRECTORY 097 00 01 
LIBRARY 097 10 01 



097 01 24 05 097 09 27 09 
195 07 19 196 19 27 



500 



53730 52857 



873 



10 
100 



SYSRES VOL.SER.R29RES 
PROCEDURE DIRECTORY 197 00 01 
LIBRARY 197 05 01 



197 00 03 09 197 04 27 09 
197 11 38 197 19 40 



24 



595 



272 



323 
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SYSTEM DIRECTORY AND LIBRARY TRACK CAPACITIES 

Figures 1-8 and 1-9 illustrate the DOS/VS system library directory and track capacities. 



r 1 

| Directory Entries Per Track | 

+ T T T _ 4 



Device 



Core Image | Relocatable 
Library j Library 
(Phases) j (Modules) 
+ 

variable | N.A. 

(maximum [ 

length | 34 
30 bytes | 

per entry) |- 

| 560 

L 

| 340 

\ ■ 

I 760 



Source 
Statement 
Library (Books) 



Procedure 
Library 
(Procedures) 



2311 



2314/ 
2319 



N.A. 
270 



3330 
3340 
3350 



440 
260 
550 



N.A. 
270 



440 
260 
550 



Figure 1-8. LIBRARIES -- System Library Directory Capacities (Entries 
per Track) 



Library | 


Library 
Block Size 
(bytes) 




Device 




Blocks per 
Track 




Blocks per 
Cylinder 








2311 




3 




30 


CORE | 






2314/2319 




6 




120 


IMAGE | 


1024 




3330 
3340 
3350 




11 

7 
15 




209 

84 

150 








2314/2319 




16 




310 


RELOCATABLE | 






3330 




28 




532 




322 




3340 




17 




204 








3350 




37 




1110 








2314/2319 




27 




540 


SOURCE J 






3330 




44 




836 


STATEMENT | 


160 




3340 
3350 




26 
55 




312 
1650 








2314/2319 




40 




800 


PROCEDURE | 


80 




3330 
3340 
3350 




61 
34 
72 




1159 

408 

2160 



L ---- ....... .. ...... ... .........J 

Figure 1-9. LIBRARIES — System Library Track Capacities 



Creating System Files 



THE PAGE DATA SET 

SYSVIS is the logical unit name of the data set that holds the virtual address area. 
It is created at IPL time from information provided by the system generation macro DPD 
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and/or the IP! DPD command. The user specifies the beginning cylinder address and the 
system calculates the size of the disk extent which is a function of the VSIZE 
specification and the disk device type, as follows: 

VSIZE = number of pages (blocks of 2K bytes) 
2 

r t 1 

| Disk Device Type | Blocks per Cylinder | 
h + ^ 

I 231M j 60 | 

y + -I 

| 3330 | 111 | 

j. + < 

| 3340 | 36 | 
I I I 

| 3350 | 240 I 

L .... -- ....... J 

The allocation requires full cylinders. 

RECORDER FILE (SYSREC) 

IJSYSRC is the filename of the recorder file that is used exclusively for output from the 
RMSR (Recovery Management Support Recorder) function. The data contained on IJSYSRC is 
edited and printed by the EREP program. The recorder file east be defined, using 
appropriate DLBL and EXTENT statements, after the first IPL procedure has been performed 
fol loving supervisor replacement and before the. £i£§t jQB §ta£gme.fi£ ig £S&&« 

The RMSR function makes several types of recordings on the recorder file, in chrono- 
logical order. The file is made up of records that contain information relating to: 

• MCAR and CCH 

• Unit Check 

• Counter Overflow 

• Tape Volume Statistics 

• IPL/EOD 

• Miscellaneous Data Recorder (2715 error records, PRT1 buffer error records, 

3330/3340/3350 non unit-check records, 3800 internal log buffer) 

• POWER/VS RJE logging. 

The IJSYSRC file is defined as a disk extent for any DASD supported as SYSRES, and the 
extent cannot be a split cylinder file. The file should not be defined on an extent 
which includes a defective or alternate track, because data may be lost. The DLBL and 
EXTENT statements should be included in the standard label area by specifying STDLABBL 
to allow recording to proceed at the beginning of each day without operator 
intervention. 

CREATING AND USING THE RECORDER FILE 

A minimum of ten tracks is required for the recorder file (STSBEC) . The following job 
stream creates the recorder file and stores the pertinent label information 
permanently in the standard label area. 

// OPTION STDLABEL 

// DLBL IJSYSRC, 'DOS/VS RECORDER FILE 1 

// EXTENT SYSREC,, „ „ , nnnnn , nnnnn 

/* 

ASSGN SYSREC, X'cuu* 

SET RF=CREATE 

'/ JOB FIRST 
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HARD-COPY FILE 



(Applicable to all systems that have a display operator console installed and DOC 
support generated) 

IJSYSCN is the filename of the recorder file that is used exclusively for output of 
information from the message area of the Display Operator Console. The symbolic 
device address of the hard-copy file is SYSREC. 

The IJSYSCN file must be defined as a disk extent for any of the D0S/V3 supported 
disk devices, and cannot be a split-cylinder file. It is to be created after the 
supervisor has been link-edited and cataloged. The following file definition 
statements create the hard-copy file: 



ASSGN SYSREC, X'cuu' 

SET HC=CREATE 
// OPTION STDLABEL 

// DLBL IJSYSCN, 'DOS/VS HARD COPY FILE' 
// EXTENT SYSREC Mr ,nnnnn,nnnnn 



/* 

// JOB FUST 



The IPL commands that precede the first // JOB statement are not copied. After the 
file has been opened, the next available and last available records are determined and 
the standard IPL message 01 2 01 IPL COMPLETE FOR DOS/VS REL xx.x ECLEVEL=nn is written to 
the hard-copy file. 

When a new hard-copy file is created at IPL time, the records of the existing file are 
destroyed. 



Distribution of DOS/VS 

Figure 1-10 shows how DOS/VS is distributed. The systeir is shipped as a SYSRES file. 
This file contains the core image library, the relocatable library, the source statement 
library, and the procedure library. 



DISTRIBUTION OF THE SYSTEM FOR DASD USERS 

DASD users receive the system on one or more disk packs. The packs are ready for your 
system generation procedure. It is recoirmended that the paqk(s) be copied ^nr 1 __tained 
for backup- For label and extent information, refer to the *ae»oranduai to Users". 



DISTRIBUTION OF THE SYSTEM FOR TAPE USERS 

Tape users receive the system on a reel of magnetic tape. This distribution tape 
contains the system as SYSRES file; it must be restored to one or more disk 
volumes. Refer to "Restoring the Distribution Tape to Disk" later in this chapter, 
After the tape has been restored, retain it for backup. 
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SYSRES File 
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:;] Magnetic Tape [jj; 



;:} DOS/VS System, Tape Distribution {ij; 



j / Initialize /:•:•: 
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Key: 

Initialize Disk Program 

Restore - Restore Tape to Disk Program 

CL- Core Image Library 

RL - System Relocatable Library 

SL - System Source Statement Library 

PL - Procedure Library 

T.M.: T. a R e . Mark ................................. 



Figure 1-10. How DOS/VS is Distributed 



Guidance on how to perforin a system generation is given under "System 
Generation and Maintenance". 



System Generation and Maintenance 

Each system generation job, that is, tailoring an IBM-supplied system to your individual 
needs, consists of a number of job steps. The job steps actually necessary and the 
sequence of their execution depends on the existing installation configuration and the 
operational packs to be built. Nevertheless, certain activities and their sequence are 
common to all situations so that a generalized system generation procedure can be 
followed. This general procedure is shown in Figure 1-11 for online and offline system 
generation. The various job steps shown are supported by programs which are listed and 
briefly described in Figure 1-12. 

For a more specific application of the generalized procedure, refer to "System 
Generation Example (Online)" where the job steps are explained in detail. 

The procedure that must be followed for processing the distribution tape (generalized 
in the frame part of Figure 1-11) depends on the availability of an operational DOS/VS. 

Users without an operational DOS/VS must restore the distribution in correspondence 
with the procedure described under "Processing the Distribution Tape (Standalone)". 

If an operational DOS/VS is available, the above mentioned standalone procedure may be 
used. However, it is recommended to follow the online procedure shown in the "System 
Generation Example" , because it requires no standalone machine time. 
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Note 1 : If RELLDR-NO, linking of components 
is the responsibility of the user. 

Note 2: Only from background (BG) partition. 

Note 3: IPL for the 64K Model 1 1 5 CPU can only 
be performed via t$A$SUPO. 



Figure 1-11. General Procedure for System Generation (Online and Offline) 
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| Name jPrograir Description/Function 



h 



CSERV 



(core image library service) to punch out (or write on magnetic tape, disk, or 
diskette) programs from the core image library. 



SSERV 



(source statement library service) to puncn out (or write on magnetic tape, 
disk, cr diskette) macro definitions from the source statement library. 



RSERV 



(relocatable library service) to punch out (or write on magnetic tape, disk, 
or diskette) the relocatable modules used to build IBM -supplied processor 
programs. 



PSERV 



(procedure library service) to display on SYSLST or to punch out (or write en 
magnetic tape, disk, or diskette) procedures from the procedure library. 



DSERV 



(directory service) to display on SYSLST the current contents of one or more 
library directories and their remaining library capacities,. The directory 
display may be either an alphabetically sorted listing or a listing of the 
entries in the order they appear in the directory. 



LSERV 



-+ 



(label cylinder display) to display on SYSLST the label cylinders located on 
SYSRES. SYSLST may be assigned to disk, tape, printer, or diskette. 



ESERV 



(de-editor program) to de-edit pre-edited macros from the E-sublibrary. It 
provides SYSLST and SYSPCH output of the original macros. It also provides an 
update facility for one macro per job step. 



MAI NT 



(library maintenance) to delete and/or catalog library elements, and also to 
condense and reallocate library extents. 



BACKUP 



to create a backup of the system on tape and/or to create a backup of private 
libraries on tape. The tape is suitable as input for the Restore program. 
See Note below. 



RESTORE 



to restore the DOS/VS Distribution Tape in a partition of a current release of 
DOS/VS. The program may be executed by statements from SYSIPT or SYSLOG. 



CORGZ 



(copy or merge ) to copy all or to copy selectively and merge elements from 
one library to another. COBGZ allows larger or smaller allocations for each 
library of the SYSRES that is being created. 



Note : Backup and Restore programs can be used efficiently to condense libraries and 



also to migrate libraries from one DASD type to another. 



Figure 1-12. Overview of Programs for System Generation and Maintenance 

For more details on these programs, refer to DOS/VS System Control 
Statement s and DOS/VS System Utilities . 
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Processing the Distribution Tape (Standalone) 

The following processing steps to initialize the disk pack to which the distribution tape 
is to be restored and to restore the distribution tape to the disk apply to installations 
that are without an operational DOS/VS- Machine configurations with and without card 
reader availability are covered. 

If your disk pack has not been initialized, follow the processing steps 
given under "Initializing the Disk". 

If your disk pack is already initialized, commence with the processing 
steps given under "Bypassing Disk Initialization". 

INITIALIZING THE DISK 

• Initialize the disk pack with a volume label and a volume table of contents (VTOC) . 
For the recommended addresses, refer to "Planning Summary" earlier in this manual. 

• Mount the distribution tape. 

• Ensure that the disk pack or data module is set for read and write operations: 

For the 3330 or 3350, set the write protection switch to R/W 
For the 3340, use a read/write data module 

• IPL from the tape unit that contains the distribution tape volume. 

• When the wait state is entered: 

For machine configurations that include a card reader, place "Job Steam A" in the 
card reader and press START and EOF on the card reader. 

For machine configurations that do not include a card reader, press ENTER on the 
DOC keyboard and when the signal sounds, type in "Job Stream A" via the DOC 
keyboard. Press ENTER key at the end of each statement; lowercase is converted to 
uppercase. 

Applicable to both types of machine configurations (with or without card reader 
availability) : 

If messages S328I and S328A appear on SYSLOG, type DELETE, hit END or ENTER 
depending on device type, and press INTERRUPT to delete unexpired files, one by 
one. To delete all unexpired files at once, type in DELETE ALL. 

The message S371I INITIALIZE DISK FUNCTIONS COMPLETED appears on SYSLOG when 
initialization is completed. 

On completion of initialization,, the system automatically initiates the restore function.. 
You. can now continue with the steps given under "Restoring the Tape to Disk". 
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BYPASSING DISK INITIALIZATION 

If the disk pack to which the tape is to be restored is already initialized, proceed as 
follows: 

• Mount the distribution tape. 

• Ensure that the disk pack or data module is set for read and write operations: 

For the 3330 or 3350, set the write protection switch to R/W 
for tne 33*40,, use a read/write data module 

• IPL from the tape unit that contains the distribution tape volume. 

• when the wait state is entered: 

For machine configurations that include a card reader, place "Job Stream B" in the 
card reader and press START and EOF on the card reader. 
- For machine configurations that do not include a card reader, press ENTER on the 
DOC keyboard and when the signal sounds, type in "Job Stream B" via the DOC 
keyboard. Press ENTER at the end of each statement; lowercase is converted to 
uppercase. 

On completion of these steps, the system automatically initiates the restore function and 
you can now continue with the steps given under "Restoring the Tape to Disk" . 



Job Stream A 



// JOB INTDSK 

// ASSGN SYSLOGjX'cuu'jdc 

// DATE mm/dd/yy 

// ASSGN SYSOPTfX'cmr' ,dc 

// ASSGN SYS00n,X'cuu* ,dc 

// LOG 

// ASSGN SYSLST,X*cuu' , dc 

// EXEC 

// UID nn 

// VTOC STETADB= (cccchhh) ,EXTENT=(yy) 

VOLlnnnnnn 

// END 

// JOB DISRST 

// ASSGN SYS005„X , CUU , ,dc 

// ASSGN SYSOOe^'cuu^dc^X'SS 1 

// ASSGN SYSOOT.X'cuu^dc 

// ASSGN SYS008,X'cuu" , dc 

// ASSGN SYS009„X' , cuu i ' »dc 

// EXEC 



disk, see Note 1 
disk, see Note 2 

optional, see Note 6 

see Note 3 
see Note 4 
see Note 5 



system residence file to be created 

distribution tape 

if PVTCLB is to be built 

if PVTRLB is to be built 

if PVTSLB is to be built 



H 



Job Stream B 



// JOB INTDSK 

I// ASSGN SYSLOG # X , cuu , ,dc 
// LOG 

// DATE mm/dd/yy 

// FILES SYSIPT.,1 

// JOB DISRST 

// ASSGN SYS005,X'CUU' ,dc 

// ASSGN SYSOOe^'CUU'jdcX'SS 1 

//ASSGN SYS007,X , cuu i ,dc 

// ASSGN SYSOOS^X'cuu'jdc 

// ASSGN SYSOO^X'cUU'V/dc 

// ASSGN SYSLST.X'CUU" „dc 

// EXEC 



system residence file to be created 
distribution tape 
if PVTCLB is to be built 
if PVTRLE is to be built 
if PVTSLB is to be built 
optional, see Note 6 



In Job Stream A and B, the job names INTDSK and DISF.ST must be used as shown 
For a description of the cuu, mm, dc, yy, and ss fields see Figure 1-13. 
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r * 

// DATE mm/dd/yy mm = 01-12 

dd = 01-31 

yy = 00-99 



T 



// ASSGH SYSxxx,X , cuu•,dc[ # X , ss , J 
xxx = logical unit 
cuu = channel and unit of device 

• The channels used by the distribution program supervisor are: 

Multiplexer (channel 0) 
Selector (1 through 6) 

dc = one of the following device type codes: 

Cl-3210/3215 Console Printer-Keyboard 
CR-Display Operator Console 

D3-2314/2319 Disk Drive 

D4-3330 Disk Storage Models 1 and 2, or 3333 Disk Storage, or 3350 Direct 

Access Storage in 3330-1 compatibility mode 
D5-3340 Disk Storage (35 megabyte data module) 
D6-3340 Disk Storage (70 megabyte data module), or 3344 Direct Access 

Storage 
D7-3330 Disk Storage Model 11 
D8-3350 Disk Storage 

Ll-1403/1404 Printer* 
L2-1443/1445 Printer* 
L3-3203, 3211, or 5203 Printer* 
L4-3800 Printing Subsystem 

Rl-2540 Card Read-Punch (reading only) 

R2-2 540 Using Punch-Read-Feed feature 

R3-1442 Card Read-Punch 

R4-2501 Card Reader 

R5-2520 Card Read-Punch 

R6-3505/3504 Card Reader 

E7-2560 MFCM or 5425 MFCO (read hopper 1) 

Tl-2400 or 3400 7-track Tape 
T2-2400 or 3400 9-track Tape 

The Restore program does not use this dd specification. Instead, the 
program determines the device type from the Format-4 label of the disk 
volume on the specified physical device. 

ss - 90 for 7-track tape unit 

CO for 9-track tape 1600 bpi 
C8 for 9-track tape 800 bpi 
♦For printers 1403, 3203. 3211, and 5203: 

ss - 7E - sense data checks 

= 73 - (default) block data checks (ignore) 
y 

// VTOC STRTADR=(cccchhh),EXTENT=(yy) 

cccchhh = cylinder and head number of starting address 
yy = number of tracks allotted to VTOC in decimal (1-30) 
h < 

|VOLlnnnnnn nnnnnn = Volume Serial Number j 

L J 

Figure 1-13. Coding Specifications for // ASSGN Statements within the Distribution 
Program Job Control 

(Refer to the preceding text "Processing the Distribution Tape".) 
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Notes to Job Streams A and B 

1- Assign SYSOPT to the disk that is to be initialized. 

2. n = 2, 3, 1, or 5. SYS002 through SYS005 are optional to specify additional disk 
devices to be initialized. These disk devices must be of the same device type as 
SYSOPT. 

3. Refer to DQS/VS Syst e m Utilities , for a complete description of the tjid control 
statement. 

For 2314/2319, nn= 

IR Previously flagged tracks are to retain their flags without surface analysis, or 

IA Denotes surface analysis on all tracks. Generation of home address (HA) and RO 
records, pref ormatting of IPL records, writing of volume label and VTOC, or 

IS For packs that have already been initialized this entry can be used to change 
the volume label (s) and the VTOC location. 

For the 3330, 3340, or 3350 Disk Storage, nn= 

IQ Quick initialization. No surface analysis. No home address generation, only 
standard RO generation, IPL records are preformatted, volume labels and VTOC 
are written, or 

IS Same as IS for 2314/2319. 

4. For 2314/2319: cccchhh = 0199000 yy = 20 
For 3330: cccchhh = 04 03000 yy = 19 
For 3330-11: cccchhh = 0807000 yy = 19 
For 3348/35ME: cccchhh = 0347000 yy = 12 
For 3348/70MB: cccchhh = 0695000 yy = 12 
For 3350: cccchhh = 0554000 yy = 30 

For each output disk specified (maximum 5) a set of 

// VTOC STRTADR= (cccchhh) ,EXTENT=(yy) 
voLlnnnnnn 

statements are to be added. 

5. nnnnnn = Volume serial number (trailing blanks only should be used). 

The IBM- supplied supervisors and standard label procedures assume nnnnnn-SYSRPJS for 
the system residence volume. 

Columns 42-51 are reserved for user's identification. A label control set consisting 
of a VTOC control statement and a VOLl control statement is required for each pack 
assigned. The label control sets apply to the assignments in the order as specified 
in the job stream and not in strict numerical sequence. 

6. If SYSLS1 is assigned, all messages and other output from the initialize disk phases 
to the communications device are also printed on SYSLST. 
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BESTORING TBE TAPE TO DISK 

After completing the processing steps given under initializing the Disk', or 'Bypassing 
Disk Initialization* , the restore distribution tape to disk procedure is performed 
immediately. 

The system issues the fcllowing two-part message: 

SR01D ***GIVE SYSTEM LIBRARY ALLOCATIONS*** 
CL= 

Type in the required allocation for the system core image library, using the format shown 
under •Allocations^ , below, and press the END or ENTER key depending on device type in 
use. 

The system will now prompt you for your allocations for the system relocatable library, 
the system source statement library, and the procedure library, using the message RL=, 
SL=, and PL=, respectively. 

After these allocations have been entered, the two-part message: 

SR32D TYPE DESIRED LABEL FOR LIBRARY 
LABEL= 

is issued. Type in the desired label to be entered in the VTOC for the system residence 
file (44 characters aaxitum) and press the END or ENTER key. If you do not type in a 
label, but respond with END or ENTER, the label will be DOS. SYSRES. FILE. The system now 
issues the message: 

SR09D TYPE GO IF ALLOCATIONS IS CORRECT 

Type in GO and press the END or ENTER key. If you want to change the allocations, just 
press the key without typing in GO, whereupon the system issues again the message SR01D. 
If you type in GO and press the END or ENTER key, the system successively issues the 
following procedural messages, provided no faults are encountered: 

SR10I FILE ID=xxx. ..xx (44x) 

SR1TI EXTENT=CYL xxxTRKxx-CYLxxx TRKxx 

SRI 21 RESTORE OF SYSTEM CORE IMAGE LIBRARY IN PROGRESS 

SR17I RESTORE HAS BEEN SUCCESSFUL 

SR12I RESTORE OF SYSTEM RELOCATABLE LIBRARY IN PROGRESS 

SB17I RESTORE HAS BEEN SUCCESSFUL 

SR12I RESTORE OF SYSTEM SOURCE STATEMENT LIBRARY IN PROGRESS 

SR17I RESTORE HAS EEEN SUCCESSFUL 

SR12I RESTORE OF SYSTEM PROCEDURE LIBRARY IN PROGRESS 

SR17.I RESTORE HAS BEEN SUCCESSFUL 

SR14.I *** RESTORE COMPLETE*** 

Besides procedural messages, error messages may be issued in the course of the library 
allocation procedure, r€fer to DOS^VS Messages. 

Allocations: 

The basic allocation format is ccc(tt), where ccc is the number of cylinders to be 
allocated to the library and tt is the number of tracks within these cylinders which are 
to be reserved for the directory. 

If an allocation of 0(0) is specified for any library, this library will not be restored. 
If you reply with EOB when prompted for the allocation, the default allocations from the 
distribution tape are used. 
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Note that these default values are the minimum library and directory space required. 
Therefore, you should always specify the values you actually need. The default values 
cannot be used when restoring the system to a 2314 or 3340 Model 35 because the storage 
capacity of these devices is too small for all system libraries. In such cases, one or 
aore of the system libraries must be restored as private libraries. Further details on 
this procedure and default values are contained in the •Memorandum to Users 1 . 

If Eccc(tt) is specified (this is only possible for RL, PL, and SL) , the requested amount 
of space will be allocated, but no entries will be made. This results in generation of 
an empty library. 

It is possible to restore system libraries (CL, EL, SL) , as private libraries if you 
wish, by specifying CL=PVT when prompted for the system library allocations. Tn this 
case, the allocations most be given for the corresponding private libraries, and the 
system will prompt you accordingly. For details refer to * Backup and Restore 1 in DQS/75 
§XStem Utilities. 



Link-Edit and Delete Procedures 



The IBM-supplied system includes cataloged procedure to perform system generation 
link-edit and delete functions for IBM-supplied system programs; the system components 
are pre- linked in the distributed system. 

The full name of the procedure to be link-edited or deleted must be formed by 
concatenating: 

Prefix* Keyword ♦£ Suffix] 

The prefix is always LINK for link-edit functions, and is always DELE for delete 
functions. Select the keyword and the suffix from Figure 1-14 according to the function 
desired; do not use the suffix for link-edit functions. 

Ex a mple J: To link-edit assembler and ESER? programs to the core image library, the 
necessary statement is 

// EXEC PBOOLINKASM 

Example 2: To delete BTAM from the core image library, the necessary statement is 

// EXEC PROC=DELEBTKC 

To delete a given component contained in different libraries, a separate procedure must 
be executed for each library. The suffix CRS (to cover all three libraries) is not 
valid. The statement // EXEC PROC=DELEBTMCRS, for example, would be invalid and not 
result in a deletion of BTAM from the libraries (core image, relocatable, source 
statement) designated by the suffix. 

Users who specifies RELLDR=N0 must re-link all desired components after IPLing a new 

supervisor. 

It is recommended to retain the link-edit and delete procedures for use after system 
generation time. The procedures can be useful for linking specific system programs to a 
private library, or for deleting programs no longer required from a private library. 
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| Keyword 




Suffix |Link 






1 of 


L ^ 




j 




Description of Component that is to be 




r T T T 1 




| Procedure 


CLE 


RLB 


SLB 1 PLB 1 




Linked or Deleted 




y 


Y + + + +- 


— 







|ADC 


c 


R 




X 


Assign Alternate Track Data Cell Utility 




|APC 


c 


R 




X 


Analysis Program- 1 




|ASM 


c 


R 




X 


Assembler and ESERV Programs 




|ATD 


c 


R 




X 


ASSGN Alternate Track Disk Utility 




|BTM 


c 


R 


S | | 




BTAM 




|CDC 


c 


R 




X 


Clear Data Cell Utility 




|CDD 


c 


R 




X 


Restore Card to Disk Utility 




|CDK 


c 


R 




X 


Clear Disk Utility 




|CD1 




R 






IOCS Nodules for IBM 1442 




|CD2 




R 






IOCS Modules for IBM 2501 




|CD3 




R 






IOCS Modules for IBM 2520 




|CD4 




R 






IOCS Modules for IBM 25 40 




JCD5 




R 






IOCS Modules for IBM 2560 




ICD6 




R 






IOCS Modules for IBM 350 5 




|CD7 




R 






IOCS Modules for IBM 3525 




|CD8 




R 






IOCS Modules for IBM 5425 




|CRD 


c 


R 




X 


Copy and Restore Diskette Utility 




|DAM 


c 


R 


s 1 1 




Direct Access IOCS 




|DDC 


c 


R 




X 


Copy Disk or Data Cell to Tape Utility 




|DEL 






1 P 1 




Delete all Delete Procedures 




|DGN 


c 


R 




X 


Dump Generator 




|DIO 


c 


R 


s 1 1 




Diskette IOCS 




|DKC 


c 


R 




X 


Copy Disk to Card Utility 




|DKD 


c 


R 




X 


Copy Disk to Disk Utility 




|DOC 


c 




s I 1 




Display Operator Console Support 




|DSK 






s 1 1 




Sequential Disk IOCS Macros 




|DST 


c 


R 




X 


Deblock Utility 




|ERP 


c 


R 1 




X 


EREP 




|E20 


c 


R 


s I | 




Model 20 Emulator Pro gran, and Data Interchange 


Function 


|FCY 


c 


R | 


S | | 


X 


Fast Copy Disk Volume Utility 




|HSD 


c 


R ! 




X 


Highspeed Standalone Dump 




| IDC 


c 


R 




X 


Initialize Data Cell Utility 




jlJB 




R | 






System Control Modules 




| IND 


c 


R 




X 


Initialize Disk Utility 




|INT 


c 


R 




X 


Initialize Tape Utility 




| ISM 


c 


R 1 


s 1 i 




Index Sequential Disk IOCS 




|IVP 






S | j 




Installation Verification Procedures 




| JBA 




R ! 




X 


Job Accounting 




| JCL 








X 


Job Control 




|KJI 


c 








Kanji Printer Support: 




|LBR 


c 






X 


Librarian Programs 




|LNK 






1 p I 




Delete all Link Procedures 




|MCR 


c 




s | | 




Magnetic Character Reader Support 




| OBJ 


c 


R 




X 


Copy File and Maintain Object Module Utility 




|OCR 


c 




s 1 1 




Optical Character Reader Support 




|OLT 


c 


R 




X 


OLTEP 




| PDA 


c 


R 




X 


Problem Determination Aids 




jPDS 


c 


R 




X 


Page Data Set Dump Utility 




|PLG 


c 


R 




X 


Print the Hard-Copy File 




|PLI 




R 






PL/I Optimizing Compiler IOCS Modules 




|PRT 


c 






X 


Buffer Load for 3203, 3211, and 5203 Printer << 
print patterns must be link-edited later) 


optional 


|PTP 


c 




s 1 1 




Paper Tape IOCS 





Figure 1-14. Keywords and Suffixes for Link-Edit and Delete Functions (Part 1 of 2) 
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S 








QTAM 




|RPG 




1 R 












RPG II Compiler IOCS Modules 




|RPS 


1 c 














Rotational Position Sensing 




j RST 


i c 


1 R 










X 


Backup and Restore Utility 




j SAP 








S 








Sample Programs 




|SDA 


1 c 


1 R 










X 


SDAIDs 




| STD 


i c 


1 R 










X 


Standard System Dump 




|SUP 








s 








Supervisor Generation Macros 




]TAP 


i c 


1 R 




s 








Magnetic Tape IOCS 




|TDC 


1 c 


1 R 










X 


Restore Tape to Disk or Data Cell Utility 




] TP1 


1 c 














Transients for Type 1 Programs 




|TRD 


I c 


1 R 










X 


Translating System Dump 




j UTS 














X 


Maintain System History Utility Program 
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1 c 


| R 




s 






X 


VSAM and Access Method Services 
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1 c 


1 R 










X 


VTOC Display Utility 




jVTM 


1 c 


1 R 




s 






X 


VTAM and TOLTEP 




j VTS 








s 
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i c 


1 R 
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Figure 1-14. Keywords and Suffixes for Link-Edit and Delete Functions (Part 2 of 2) 
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Generation and Maintenance Considerations 



VOLUME SERIAL NUMBERS AND LABELS 

If the IBM-supplied system is on disk, the serial number of that disk pack is SYSRES. If 
the system is shipped on tape, the disk pack to which the tape will be restored is 
assigned a volume serial number during the initialize disk run. 

For both types of IBM-shipped systems (tape and disk) , the standard labels defined by 
the DLBL and EXTENT statements are adequate for system generation, but the EXTENT 
statements oust be adjusted to reflect the volume serial number chosen for the disk 
volume to which the tape is to be restored. To use the standard labels for 
configurations with two disks, SYSLNK, SYS001, SYS002, and SYS003 can be assigned to the 
second disk. IBM supplies procedures LABELS30, LABELS40, and LABELS50. These procedures 
load standard labels for the 3330, the 3340 Model 70, and the 3350, respectively if 
default sizes for the libraries are used when the system is restored. 

Standard labels (OPTION STDLABEL) are not defined for any file on the system 
aistriluted by IBM. A reply of "delete" to the message 

4444A OVERLAP ON UNEXPIRED FILE 

destroys the system residence file unless it is encountered during a MAINT reallocation 
run. 



COMPILATION OF IOCS MODULES 

To use some compilers, a number of IOCS modules must be cataloged in the relocatable 
library of each operational pack. IBM supplies these modules preassembled in the 
relocatable library for the compilers that use them. These IOCS modules are link-edited 
into compiler generated object programs as required. These modules are generated using 
the following macro definitions supplied by IBM: 

CDMOD Card Reader/Punch - 3 881 Optical Mark Reader 

PRMOD Printer 

MTMOD Magnetic Tape 

SDMODxx Sequential DASD. SDMOD consists of ten similar macro definitions: SDMODFI 
for sequential disk with fixed input, SCMODFO for sequential disk with fixed 
output,, and so on. A complete description of SDMODxx is contained in DOS/VS 
Supervisor an d I/O Macros . 

ISMOD Index Sequential Access Method, DASD 

DAMOD Direct Access Method, DASD 

DIMOD Device Independent Module 

With assembler language you can, if you wish, assemble these IOCS functions separately 
and catalog them into the relocatable library. Separate assembly of IOCS modules 
requires no additional real storage or additional execution overhead. Those modules, 
shipped preassembled for IBM components,, can also be used by any other program, if 
applicable,. A separate assembly is preferable because: 

• Program assembly and reassembly time is minimized. 

• IBM-supplied IOCS modules used . by compilers may also be used by your application 
programs- Use of these modules reduces the assembly time of your application 
programs.. 
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• Use of preassembled IOCS modules facilitates program maintenance and standardization. 

• The xxMOD macro definitions just cited require a substantial number of cylinders in 
the source statement library. 

The corresponding generated modules ordinarily require fewer cylinders in the 
relocatable library. Thus* you may prefer to retain xxMOD macro defintions only on 
the system backup volume, cataloging a selection of generated modules onto each 
operational volume. 

Support of the EPS feature of IBH 33zx disk storage devices is provided in S&M and DAN, 
and Device Independent Access Method by preasseibled and link-edited versions of the 
logic modules that reside in the core image library and are subsequently loaded into the 
SVA. This support is also provided in ISAM for IBM 3330 Model 1 or 2, 3333, or 33U0. 
The modules are linked to the problem program during execution of problem programs and 
process the DTF requests. BPS modules are usable by DASD'DTFs in your system. Only one 
copy is in the SVA if pre-loaded during IPL, otherwise multiple copies in the system 
GETVIS area can occur. If BPS support is not used, these modules can be deleted from the 
core image library. 

AVOIDING LOSS OF SYSTEM LIBRARIES 

During each system generation and maintenance procedure, system libraries should be 
copied periodically on magnetic-tape reels or disks tc provide backup in case of 
subsequent specification errors or machine errors. 

The programs Backup or FASTCOPY can be used for copying from disk to tape; the CORGZ 
or FASTCOPY programs can be used for copying from disk to disk. Using Backup and Restore 
together, or the program CORGZ, your libraries will be condensed. For details of these 
programs refer to DOS/VS System Control Statements and D OS/VS System utilities . 

OBTAINING LIBRARY STATUS INFORMATION 

Perform a DSERV, or check a system directory printout to determine the contents and sizes 
of the system libraries during system generation to determine that enough blocks remain 
for link-edit and catalog procedures. A DSERV run requires the following control 
statements : 

// JOB DSERV 
// EXEC DSERV 
DSPLYS ALL 
/* 
/£ 

A printout of the library status is provided automatically following a linkage edit with 
an OPTION CATAL specified or any // EXEC MAINT. 

USING SYSRES LIBRARIES AS PR IV ATE LIBRARIES 

Before changes can be made to one of the system core image, system relocatable, and 
system source statement libraries of a non-IPLed system, the respective library must be 
declared as private. To do so, it is required that DLBL and EXTENT statements defining 
the exact library size are included into any job stream making use of the libraries. The 
following examples show the required job control statements: 

For a system core image library: 

// DLBL IJSYSCL,, ' DOS . SYSRES . FILE • 
// EXTENT SYSCLB, SYSRES, 1,0,2, 197 8 
ASSGN SYSCLB, X' 161' 
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For a system relocatable library: 

// DLBL IJSYSRL, 'DOS, SYSRES. FILE' 

// EXTENT SYSRLB, SYSRES, 1,0,1980,2040 

// ASSGN SYSRLB, X*161' 



For a system source statement library: 

// DLBL IJSYSSL,, 'DOS. SYSRES. FILE' 

// EXTENT SYSSLB, SYSRES, 1„ ,40 20,2820 

// ASSGN SYSSLB, X f 161* 



AUTOMATIC DOCUMENTATION OF SUPERVISOR GENERATION MACROS 

Normally, when examining a supervisor listing, it is difficult to determine which 
supervisor generation macros were used for the assembly. If, however, the supervisor 
generation macros are invoked by means of an outer user macro (which in turn calls the 
required generation macros) then the assembler will list the outer macro before 
assembling the supervisor, and thus all the generation macros used are listed together. 
All that is required to use this technique is the inserticn of the four macro 
instructions labeled (J) through (5) below (refer also to Figure 1-6): 

// EXEC ASSEMELY 

MACRO (T) 

GENSOPVB © 

normal supervisor generation job 
stream without the END statement 

MEND _ 

(D 

GENSUPVR 

END 
/* 
UTILIZATION OF THE MAINTAIN SYSTEM HISTORY (PTFHIST) PROGRAM 

To have a history of system updates available is a prerequisite for efficient system 
service, it helps to reduce system down-time. Therefore, whenever a new release of 
DOS/VS is installed, the PTFHIST program should be initialized and linked to the core 
image library of your DOS/VS. 

When a system update (by APAR fix or by installation of one or more PTFs) is performed, 
this should be done only with the PTFHIST program. 

Linking the program and using PTFHIST for system update are the prerequisites for 
automatic maintenance of the system update by DOS/VS. 

The system generation example given later in this module shows how to initialize the 
program and link it to your system core image library. Refer to DOS/VS System Utilities 
for information on how to use the program. 

Another important tool for efficient system service is the IBM- provided List System 
History (HISTLIST) utility program. This program produces system history listings that 
are helpful when the system service level needs to be established. Refer to P.2S/YS 
§ISi§§ Utilities for information on how to use the program 
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Library Maintenance 

DOS/VS libraries can be maintained by using the MERGE function of the CORGZ librarian 
program. The MERGE function allows to merge complete libraries or selective library 
entries into existing libraries. Before using the MERGE function, ensure that the 
library to which new entries are to be merged contains sufficient space for the new 
entries. The following discussions apply to all libraries. For further information 
refer to D05/V.S. System £gnt£ol Statements. 



REPLACING IDENTICAL ENTJIiU USING THE MERGE FUNCTION 

When transferring entries that have names identical to those of existing library eQtries, 
the old entry (name of phase, module, book, or procedure) is deleted from the library's 
directory, and the new entry is added to the end of the library's directory. The phase, 
module, book, or procedure is added to the end of the library. 



Jk£2ING UNIQUE £NTR£ES. US.ING THE MERGE FUNCTION 

When uniquely named phases are transferred to an existing core image library, the names 
of the entries are inserted in the directory in alphabetical sequence for modules, books, 
or procedures, the entries are inserted at the end of the directory. The actual phase, 
module, book, or procedure is added to the end of the library. 

COPYING SELECTIVELY TO M ERGE LIBR ARIES 

If two libraries are to be merged, it is faster to selectively copy (MERGE) to the 
library containing the greatest number of desired entries because the number of entries 
transferred and directory searches made are kept to a minimum. If there is insufficient 
space in a library to accommodate additional entries, unwanted entries can be deleted, 
the library can be condensed,, and the new entries can then be added to the library. 

DELETING UNWANTED ENTRIES AND MERGING AN ENTIRE LI BRARY WI TH ANOTHER LIBRARY 

A second technique is to use the IBM-supplied delete procedures to delete all unwanted 
entries from a library and copy the entire library to another library, thus merging the 
two libraries. Using this technique requires that the receiving library contains enough 
space to accommodate the entire library being copied. If there is insufficient space, 
the receiving library must be condensed or reallocated. 

COPYING SELECTIVELY FROM TWO LIBRARIES TO CREATE A THIRD LIBRARY 

If there is insufficient space to accommodate a merge of two libraries, a third library 
can be created to contain selected entries from the two libraries that are to be 
contained in the merged library. This technique eliminates the need for condensing or 
reallocating an existing library. Note that this technique can be applied by using only 
two disk drives. 

DELETING UNWANTED ENTRIES FROM TWO L IBRARIES AND MERGING BOTH LIBRARIES TO CREATE A THIRD 
LIBRARY 

Another technique for merging two libraries is to delete unwanted entries from the two 

existing libraries,, and merge the two libraries, in their entirety, by copying them to 

create a third library. Note that this technique can be applied by using only two disk 
drives. 
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System Generation Example (Online) 

The following illustrates an online system generation joJo with a system and I/O device 
configuration as shown in Figure 1-15. The job steps required for this generation are 
illustrated in Figure 1-16 with accompanying text explaining the steps in detail, 

The example applies to both the tape and the disk distributed systems. Prerequisite 
is an operational DOS/VS. Users without an operational DOS/VS are referred to 
"Processing the Distribution Tape" in the preceding text, before commencing with the 
generation job. 




Current SYSRES 

Unit X'160' (IPL-Device) 

SYSRES 

SYSVIS 

SYSLNK 

SYS001 

SYS002 

SYS003 

SYSREC 



Unit X'OOD' 



3330/ 
3340 



New SYSRES 
UnitX'161' 



SYS LOG 



Device 



Channel 



SYSLST 



Unit 



SYSRDR 
SYSIPT 



SYSPCH 



__ 




— 


3505 





oc 


3525P 





0D 


3211 





0E 


3210/3215 





1F 


3330 or 3340 


1 


60 


3330 or 3340 


1 


61 


341 0T9 


2 


80 



Use 



Card Reader (SYSRDR, SYSIPT) 

Card Punch (SYSPCH) 

Printer (SYSLST) 

Display Operator Console 

Disk (SYSRES, SYSLNK, SYSREC, SYS001, SYS002, SYS003) 

Disk (new systems to be generated) 

Magnetic Tape 



Figure 1-15. Example of System and I/O Device Configuration 

Results of System Generation 

When system generation is completed, the operational system pack of the installation 
contains user selected components and programs in its core image library, together with 
an IBM-supplied or the installation's tailored supervisor and the job control, linkage 
editor, and librarian programs. The core image, relocatable, and source statement and 
procedure libraries are condensed, and IOCS modules are assembled and cataloged to the 
relocatable library. 
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Figure 1-16. Job Steps of Online System Generation 
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DESCRIPTION OF JOB STEPS 

Users receive the IBM-shipped system according to their installation's device 
configuration. 

Tape users receive DOS/VS on a self-loading reel of magnetic tape which is capable of 
being restored onto disk* The tape contains the entire SYSRES file. The generation 
example assumes an operational DOS/VS. To commence the generation job, mount the 
IBM-supplied tape and proceed to step 1 of the example* 

Users without an operational DOS/VS must first complete the procedures described 
previously under •Processing the Distribution Tape (Standalone) 1 and only then can they 
commence the generation job, starting with Step 13 and continuing in the following step 
sequence: 1*, 5 through 12 followed by Steps 15, 16, and 17. 

DASD users receive DOS/VS on a disk (data module) containing a core image, relocatable, 
source statement, and a procedure library. To commence system generation, mount the 
IBH-supplied volume and proceed to Step 3 of the example. 

As indicated in Figure 1-16, some of the steps may be performed only from the background 
(BG) partition. 



££§£ © I ni tiaj.4gg liiS £i§* 

Users of VM/370 restoring DOS/VS to minidisk(s) must initialize such disk(s) by means of 
the initialize disk utility IBCDASD (available with VH/370) and specify the number of 
cylinders required. Then, the OS work pack must be converted into a work pack suitable 
for DOS/VS. To do so, specify// DID IS in the utility modifier statement of the DOS/VS 
Initialize Disk Utility (see D OS/ VS System Utilities) . 

Mount the distribution tape, if you plan to use a removable disk pack for system 
residence, and the disk that is to contain the system. For details refer to DOS/ VS 
SyjiJ&l Utilities, if the disk is not yet initialized, run the Initialize Disk utility. 

Given below is a sample job stream for system residence on a 3348 data module, model 70: 



// JOB 
// ASSGN 
// EXEC 
// UID 
// VTOC 
V0L1SYSBES 
// END 



INIT 334 8 MOD 70 

SYS000,X»161« 

INTDK 

IQ 

STBTADR=(0695G00) ,EXTENT=(12) 



For other disk volumes, the values to be specified for parameters STRTADR and EXTENT are 
as follows: 

STRTADF= (0403000) for a 3336 disk pack; (0807000) for a model 11 disk pack 

STBTADR= (0199000) for a 2316 disk pack 

STRTADR=(03470CO) for a 3348 data module, model 35 

STBTADR= (0695000) for a 3348 data module, model 70 

STRTADR^ (0554000) for a 3350 

EXTENT=(19) for a 3336 disk pack, all models 

EXTENT-. (20) for a 2 316 disk pack 

EXTENT={12) for a 3348 data module, model 35 

EXTENT= (12) for a 3348 data module, model 70 

EXTENT=(30) for a 3350 
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51©E © Igstore the Disk 



For details see 'Backup and Restore System* in DpS/VS System Util it ies. 
For 3348 data nodule, acdel 70 



new systea residence pack 

(see Note 1) 
distribution tape 



// JOB RESTORE TO DISK 

// ASSGN SYS0C5,X» 161* 

// DLBL IJSYSBS, 'DOS. SYSRES. FILE', 99/365 

// EXTENT SYS005,, 1,0, 1,2887 

// ASSGN SYS006,X'280' 

// EXEC RESTORE 

ALLOC CL=25(6) ,RL=36 (6) ,SL = 87{4) ,PL=3 (3) (see Note 1} 

/* 

HTC RON,SYS006 

/& 

iJ°£§ X- Extents and allocations are a sample for a 3348 data module. For further details 
on extents, refer to the 'Memorandum to Osers.' 

For 3348 data module, model 35 and 2316 disk pack, the system as distributed is too large 
for a single pack. The following job stream should be used for restore: 

// JOB RESTORE DISTRIBUTION TAPE TO T90 PACKS 3348-35 



new system residence pack 

(see Note 2) 
distribution tape 

(see Note 2) 



private library on X'161 1 
private source statement library 



// ASSGN SYS0C5,X»161« 

// DLBL IJSYSRS,' DOS. SYSRES. FILE', 99/365 

// EXTENT SYS0O5,,1,O,2C51 

// ASSGN SYS006,X»280' 

// EXEC RESTORE 

ALLOC CL=59(9) ,RL=94 (8) ,SL=E8 (2) ,PL=8(3) 

/* 

HTC EEW,SY£006 
// PAUSE 

// ASSGN SYS009,X« 161' 

// DLBL IJSYSSL, 'DOS. SYSSLB. FILE', 99/365 
// EXTENT SYS009,,1,0,12,2784 
// EXEC RESTORE 

ALLOC CL=P?T,PS=23 (4) 

/* 

HTC PUN,SYS006 

/e 

Note 2: Extents and allocations are a sample for 3348-35. For further details on 
extents, refer to the 'Memorandum to Users'. 

The Restore program can be used online under control of a previous DOS/VS release. 
However, the program must be cataloged to the current systea before it can be executed. 
To catalog the program, invoke the job stream contained on the fourth file of the 
distributed tape from the console as follows: 



(see Note 2) 



1 . Enter commands 

ASSGN SYSIN,X'280' 
HTC FSF,SXSIN,3 



2. Press END/ENTER 

3. Enter commands 



(distribution tape) 

(for a 1600 bpi tape; for an 800 bpi 
tape enter HTC FSF,SYSIN,1 for the second 
volume) 

(causes the Eestore program to be cataloged) 



MTC REW,SYSIN 
ASSGN SlSIN,X»CUU* 



(input reader) 
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Note : If a phase with the name RESTORE is already present in the current system, ensure 
that it is not overwritten. This can be done by either of the following: 

• Catalog the new RESTORE phase into a private core image library, or 

• Rename the current phase before executing the above job stream. 

Ste p © Copy the New Procedure Library to the Curre nt System 

This step can only be executed in the background partition of the system. 

To copy the new system procedure library to the current system procedure library, use 
the following job stream. 

// JOB COPY 

// ASSGN SYS002„X'161' 

// DLBL IJSYSRS, 'DOS.. SYSRES.FILE' 

// EXTENT SYS002,SYSRES 

// EXEC CORGZ 

MERGE NRS,RES 

COPYP ALL 
/* 
/& 

Note : When copying the new library to the current system procedure library, procedures 
having the same name will be overwritten. Also, ensure that the current procedure 
library has sufficient space to accommodate the new procedure library. 

Step Q Use System Li b raries as Privat e Libraries 

System libraries supplied by IBM can be used as private libraries of an existing DOS/VS 
if that system , s supervisor was assembled with PCIL=YES specified in the FOPT generation 
macro. This approach requires that DLBL and EXTENT statements as shown are included in 
the pertinent job stream for each of the three system libraries: 

// DLBL IJSYSxL, 1 DOS. SYSRES.FILE' 

// EXTENT SYSxLB,SYSRES,1,0,trackaddress,no. of tracks 

where x = C for core image library 
E for relocatable library 
S for source statement library 

trackaddress = 2 for private core image library; for the remaining two libraries, this 
address has to be computed by adding the length of the preceding library 
(including its directory) to the address of that library. 

no. of tracks= length of the library in number of tracks. 
Step © Delete Unwanted C ompo nent s 

This step can only be executed in the background partition of the system. 

Delete unwanted components by executing the appropriate procedures. Declare new 
libraries as private libraries. Example for a core image library: 

// DLBL IJSYSCL, 'DOS. SYSRES.FILE' 

// EXTENT SYSCLB,SYSRES„ 1,0, 2,1978 system core image library portion 

ASSGN SYSCLB^'iei* 

Step © Assemble Your Own Supervisor 

To access the new system release while under control of the current system, the 

new libraries must be defined as private libraries; refer to "Use System Libraries as 

Private Libraries", above. 



Module 1: Planning and Procedures 97 



In this step, decide whether to use one of the IBM-supplied supervisors or to assemble 
your own supervisor. Display the source (contained in the source statement library) of 
the IBM-supplied supervisors (contained in the core image library) by executing: 

// JOB DSPLY 

// DLBL IJSYSSL, 'DOS. SYSRES. FILE' 

// EXTENT SYSSLB, SYSRES,, 1,0,4020,2880 

// ASSGN SYSSLB, X' 161* 

// EXEC SSERV 

DSPLY A. SUP0,A.SUP1, ,A.SUP6 

/* 
/& 

If one of the IBM-supplied supervisors suits your requirements, continue with Step 8. 
Otherwise, assemble your own supervisor using DLBL and EXTENT statements as in the 
following example for a new source statement library (see also Figure 1-6) : 

// DLBL IJSYSSL, 'DOS. SYSRES. FILE* 

// EXTENT SYSSLB,SYSRES„l lf 0, 4020, 2880 

// ASSGN SYSSLB, X ? 161' 

for 64K Model 115 CPU configurations, either select $$A$SUP0 or assemble a supervisor 
whose storage requirements do not exceed 44K bytes. $$A$SUP0 provides for a single 
partition, includes RELLDR=YES, but does not support POWEE/VS. Device assignments are 
identical to those for $$A$SUP1 (see Figure 1-24) . 

Step Q Catalog Your Supervisor 

Catalog the assembled supervisor (object module from Step 6) to the core image library. 
Alsc catalog printer form-control buffer and the universal character buffer images as 
required (see "Buffer Load" later in this module) . 

// JOB CATALSUP 

// DLBL IJSYSCL, 'DOS. SYSRES. FILE' 

•./ EXTENT SYSCLB^SYSRES^l.O^igTS 

ASSGN SYSCLBfX'iei* 

// OPTION CATAL 

ACTION CLEAR 

INCLUDE 

Supervisor object deck here 
/* 

// EXEC LNKEDT 
/& 

Step © Backup Libraries 

The following job stream may be used to create a backup of your system and/or private 
libraries on tape. The backup is suitable as input to the Restore program. For the 
Restore JCL, refer to Step 2. 

// JOB BACKUP SYSTEM AND/OR PRIVATE LIBRARIES 

// ASSGN SYS005, X'cuu' system library disk, if system backup desired 

// ASSGN SYS006,X'cuu' tape where backup is to be written to 

// ASSGN SYS007,X'cuu' private CLB, if backup is desired 

// ASSGN SYS008,X'cuu' private RLB, if backup is desired 

// ASSGN SYS009,X'cuu' private SLB, if backup is desired 

* Unassign any library that is not to be backed up 

// ASSGN SYS004,UA if standalone tape is not to be produced (see Note) 

// DLBL I JSYSRS, 'DOS. SYSRES. FILE' 

// EXTENT SYS 00 5 

// DLBL IJSYSCL, 'DOS. PVT. CLB. FILE'' 

// EXTENT SYS 007 

// DLBL IJSYSRL, 'DOS. PVT. RLB. FILE' 

// EXTENT SYS 00 8 

// DLBL IJSYSSL W 'DOS. PVT. SLB. FILE ' 

// EXTENT SYS009 

MTC REW,SYS006 backup does not rewind at OPEN or CLOSE 
// EXEC BACKUP 
/£ 
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fiote: For the description of the standalone backup and restore, refer to £QS^V§ Sisteg 
Utilities. 

If several private libraries are to be backed up,, you iray execute BACKUP several times 
to place these libraries on the same tape. These libraries may be restored with RESTORE 
which must be executed the same number of times as BACKUP was executed. If you use the 
standalone Restore program, you must forward space the tape two files to bypass one 
execution of BACKUP. 

Figure 1-17 shows (1) the library identifiers to be used in the ALLOC statements for a 
later restore run and (2) the associated logical units and file names. 



r t 

| Identifier | library 



*t 1 1 

|Logical Unit | File Name | 



CL | System Core Image Library | SY-S00 5 | IJSYSRS 
RL | System Relocatable Library | SYS005 | IJSYSRS 
SL j System Source Statement Library | SYS 005 | IJSYSRS 
PL | System Procedure Library | SYS005 (IJSYSRS 
PC j Private Core Image Library | SYS 007 | IJSYSCL 
PR | Private Relocatable Library | SYS008 | I JSYSRL 
PS [Private Source Statement Library | SYS009 | IJSYSSL 
x x x 



Figure 1-17. 



Library Identifiers , File Names, and Logical Units for 
the BACKUP and RESTORE Utility 



Step © Restore the Syste m 

To restore the system and also your private libraries, use the job stream given in Step 
2. On completion of the job, all libraries are condensed. 

Step ® Merging User Programs 

Use the CORGZ program to merge the contents of an existing system residence disk pack 
with the contents of a new system residence disk pack, retaining the existing members of 
the destination library if duplicates occur. The control statements needed for this 
operation are: 



// JOB MERGE 

// DLBL IJSYSRS, »DOS.SYSRES. FILE* 

// EXTENT SYS002 

// ASSGN SYS002,X•161 , 

// EXEC CORGZ 

MERGE RES,NRS 

COPYC NEW 

COPYS NEW 

COPYR NEW 

COPYP NEW 



new SYSRES 

device for new SYSRES 



Provide COPYx statements as required. 
At least one COPYx 
statement must be given. 



For further information on the CORGZ program, refer to DOS.^VS. §ysteg Control Statements. 

Note; Phases $$A$SUPx, if contained in the current CIL directory, will not be merged to 
the new CIL directory. Such phases are assumed to be supervisors and must be compiled 
again on the new system. Phases $$BFCBxx, $$BUCBxx, SJOBACCT, and SSYSOPEN, if found in 
the current directory, are merged to the new CIL directory even if they are present 
already. 

S tep Q) Assemble I/O Modules 

Perform all other necessary assemblies. A- library macros such as, for instance, licensed 
programs supplied in A-macro format, must be edited before they can be assembled. The 
component assemblies should be performed as separate jobs. 
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For the information required to assemble Emulator Programs, refer to the Emulator 
Program manual listed in the Preface. ~ 

Assemble all your required IOCS modules. By assigning SYSPCH to a tape unit, disk 
extent, or diskette extent, the IOCS modules can be cataloged to the relocatable library 
without punching them in cards. The IOCS modules required by compilers, as defined in 
"Module 7: Compiler IOCS Modules", are contained in the IBM-supplied relocatable 
library. 

Close the tape assigned to SYSPCH and reassign SYSPCH to its permanent assignment by 
using the CLOSE command . The assembly listings should be checked for errors before 
proceeding. 

Note : Do not include a START statement in your assembly. 

Given below is a sample job stream for the assembly of a CDMOD and MTMOD I/O module. 

r " 

// JOB ASSEM 

// OPTION DECK,. LIST, LOG, NOXREF 

// ASSGN SYSPCH^X^aO' 

// EXEC ASSEMBLY 

PRINT NOGEN 

CDMOD RECFORM=FIXUNB,CTLCHR=ASA,TYPEFLE=OUTPUT,IOAREA2=YES, X 

DEVICE=3 52 5 , SEPASMB=YES 
END 
/* 
// EXEC ASSEMBLY 

PRINT NOGEN 

MTMOD RECFORM=FIXBLK w READ= FORWARD, SEPASMB=YES 
END 
/* 

CLOSE SYSPCH, X' 00D* 
/£ 

♦Check assembly listings for errors. Reload 280 with same tape. 
// PAUSE if correct press end to continue 

The multipart forms of the linkage editor maps and the supervisor listing will be 
required by your IBM customer engineer for maintenance purposes. 

Before the next step is performed, check the linkage editor listings, and make all 
necessary corrections. 



Step ® Catalog IOCS Modules 

This step can only be executed in the background partition of the system. 

Reload the tape that was assigned to SYSPCH in Step 11 and assign it to SYSIPT. Witn 
this tape the MAINT program catalogs the IOCS modules to the relocatable library. 

r ■ 1 

| // JOB CATALRLB 

|// ASSGN SYSIPT f X' 280* 

| * CATALOG MODULES TO RELOCATABLE LIBRARY 

|// EXEC MAINT 

|/e 

L - 

The basic SYSGEN is complete. You may set new standard labels, reallocate library sizes 
by using the copy function (COEGZ) , condense the libraries, and" set condense limits if 
required. Copy the operational pack for backup. 
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Step (& IPL New S YSRE S 

Perform IPL and format your new page data set using the IPL DPD command including 
TYPE=F. To improve system performance, set up an SVA and build an SDL. You may use one 
of the IBM-provided procedures for this purpose (see "Introduction" in this module) , or 
specify the phases whose names are to be included in the SDL by submitting a SET 
SDL=CEEATE command (see the example below) . If you do not wish to retain a procedure 
library, you should punch out the procedure, using the PSEEV program, and include it in 
your set of IPL commands. 

Example : 

ADD commands (optional) 

SET DATE etc. 
DPD options 
SET SDL=CREATE 
phase name 

/* 

ASSGN commands 
SET RF=CREATE 

The IBM-provided procedure (or the command SET SDL=CREATE) must precede job control 
commands such as ASSGN. These procedures can be executed only in a multiprogramming 

environment (NPARTS>1) . 

When IPL is complete, enter the SET job control command to create the recorder file. 
If your CPU is equipped with a display operator console, include HC=CREATE in the 
command to cause the creation of a hard copy file. For more information on these 
procedures, refer to DOS/VS System Management Guide > 

Step @ Standard L abels and Ha rdcopy File 

Define label information for SYSRES, SYSLNK, SYSREC, SYS001, SYS002, and SYS003. In 
addition you may include any label information required for your installation. If your 
system resides on a 3330, 3340 Model 70, or 3350 you may use the provided procedure 
LABELS30, LABELS40, or LABELS50 respectively, to load the default standard labels, or you 
may define your own standard labels as follows: 

r 1 

// OPTION STDLAEEL 

// DLBL IJSYSRS,*DOS SYSRES . FILE f , 99/36 5, SD 

// EXTENT SYSRES, nnnnnn, l„n, 0001,, nnnn 

// DLBL IJSYSLN,' SYSTEM WORK FILE NO. 0», 99/365, SD 

// EXTENT SYSLNK,, nnnnnn,, l,n, nnnn., nnnn 

// DLBL IJSYS01," SYSTEM WORK FILE NO. 1', 99/365, SD 

// EXTENT SYS001, nnnnnn, l„n, nnnn, nnnn 

// DLBL IJSYS02,'' SYSTEM WORK FILE NO. 2', 99/365, SD 

// EXTENT SYS002, nnnnnn, l,n, nnnn, nnnn 

// DLBL I JSYS03,' SYSTEM WORK FILE NO. 3', 9 9/3 6 5, SD 

// EXTENT S YS0 03,, nnnnnn, l,n, nnnn, nnnn 

// DLBL IJSYSRC'DOS RECORDER FILE 1 , 99/365, SD recorder f J le 

// EXTENT S YSREC, nnnnnn, l,n, nnnn, nnnn 

// DLBL IJSYSCN, 'HARDCOPY FILE' , 99/365, SD hard copy file 

// EXTENT SYSREC, nnnnnn, l„n^nnnn,nnnn 



// DLBL IJSYSIN, ,, DTTEPTF , 1# ,DU 

// EXTENT SYSIN 

// EXTENT SYSIN 

// EXTENT SYSIN 

/& 



SYSIN labels for 
diskette PTF for 
cardless systems 
only 



In addition , you may now perform an LSERV and an LVTOC to obtain a listing of the labels 
stored on the label cylinder (s) and in the VTOC. 

// JOB DISPLY 

// EXEC LSERV 

// ASSGN SYS004,X , 160 , for your system residence pack 

// ASSGN SYS005,,X" 00E* for the printer 

// EXEC LVTOC 

/£ 

Step fl-> DSERV and Link PTFHIST 

Perforin a sorted DSERV to display the directories for later reference using the following 
statements: 

// JOB DSERV 
// EXEC DSERV 

DSPLYS ALL 
/£ 

Initialize and link the Maintain System History (PTFHIST) Utility (see also section 
"Utilization of the Maintain System History (PTFHIST) Program" earlier in this module) 
using the following statements: 

// JOB PTFHIST 
// OPTION DECK 
// EXEC ASSEMBLY 

HIST for parameters, see "HIST Macro Description" 

END in "Module 24: System Utilities". 

/* 
/£ 

Execute the job stream generated on SYSPCH. 

Step <B) Assemble IVP 

Perform an assembly of the Installation Verification Procedure. The output consists of a 
job stream to execute the selected IVP functions. Output is on SYSPCH which can be a 
card punch, a tape drive, a disk drive, or a diskette. You can also generate a job that 
deletes the IVP books that were used in the assembly. If you choose to do this,- however, 
bear in mind that it will be impossible to do a reassembly of the IVPGEN macro during 
this system generation. 

Refer to "Module 3: Installation Verification Procedure" for a comprehensive 
description of the operating instructions for IVP. 

r 1 

|// JOB IVP GENERATION 

]// EXEC ASSEMBLY 

| IVPGEN VERIFY=NO, [DELUSED=YES, ] selected IVPGEN parameters 

| END 

|/* 

]// PAUSE the output on SYSPCH must now be read on SYSIN 

|/S 

L 

Step <E* Backup Libraries 

Now you should take a backup by using the Backup or FASTCGPY programs as shown in Step ! 
of this example. 

Unsuccessful Generat ion 

If the generation proved unsuccessful, repeat the appropriate job step or call your IBM 
representative. 
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DOS/VS System Program Sizes and Component Storage Requirements 



Component 



IBM 

Program 
Number 
5745-SC 



Core Image 
Phases 



Library 



Blocks 



Relocatable 
Library 



Prefix Blocks 
Modules 



Source 
Statement 
Library 



Books Blocks 



Attention Routines,, 
Initiators, 



AIT 
(Note 1) 



Terminators 6 Dumps 



Standard System Dump 

Translating System 

Dump 

Attention Routines, 

Initiators, 

Terminators 



11* 
11* 



33* 



13 
13 



38 



IJB 12 70 
UB 12 71 



Assembler & ESERV 



Programs 

Assembler 

ESERV 



ASM 
(Note 2) 



2 
<IVP) 



19 

7 



122 
41 



IPKA 38 609 
IPKV 10 218 



44 



BTAM 



BTM 
(Note 2) 



52 
29* 



52 
37 



IJL 65 179 



66 



8620 



Checkpoint/ 
Restart 



CKR 
(Note 1) 



14* 



22 



26 



Direct Access (Disk) 
IOCS 



DAM** 
(Note 2) 



11* 



12 



IJI 28 246 



1273 



-j 

50 3 



Diskette I/O Unit 



DIO 



19* 
6* 



19 
6 



Disk ERP 



DKE 
(Note 1) 



411 

407 



Display Operator 
Console Support 
(PBINTLOG) 



DOC 
(Note 1) 



31* 

1 



31 
5 



IJB 



20 



Sequential Disk 
IOCS 



DSK** 
(Note 2) 



30* 



30 



IJG 55 344 



11 



6648 
< 



Emulators 



1401/1440/1460 
Emulator 
1410/7010 
Emulator 
j. 

Model 20 Emulator 

Environmental Re- 
cording,, Editing,, 
and Printing (EREP) 



5747-CC3 



(Note 2) 



-+ 



E20 
(Note 2) 

ERP 
(Note 2) 



25* 

7 



40 

7 



IIS 73 506 



23 






1* 
131 



IJB 



127 1632 



2471 
< 






344 
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T T 

Core Image Library 
Phases Blocks 



t n 

Source 
Statement 
--| Library 



Component 



IBM 

Program 
Number 
5745-SC 



"f 



+" 



Relocatable 
Library 



Prefix Blocks 
Modules 



Books Blocks 



Compiler IO CS 
Modules 



IOM 
(Note 2) 



32* 



108 



CCBOL 
PL/ 1 



ANS*** COEOL 
ANS*** COBOL S 
ANS*** COBOL 6 
ANS*** COEOL, 

COBOL, and PL/I 
COEOL 

COBOL and PL/I 
PL/ 1 
RPGII 

Required IOCS 
Modules 



Note : This program 
consists of a 
group of various 
preassembled IOCS 
modules used by 
American National 
Standard COEOL, 
PL/I, and COBOL. 
The digits given 
here represent 
the number of mod- 
ules used and the 
number of library 
blocks required by 
the various combi- 
nations of compi- 
lers desired. 



226 


1388 


148 


991 


163 


1181 


169 


1100 


341 


1272 


77 


578 


107 


698 


70 


412 


161 


876 


27 


100 



-+- 



+- 



IOCS (See Note 2) 



IOX** 



60* 



61 



Card (Reader/Punch) 

Console 

Device Independent 

(DTFDI) 

Printers 

Serial Devices 

PIOCS (DTFPH) 

DTFBG 

DTFEN 

Imperative Macros 

Rotational position 

Sensing 



(Note 1) 



IJC 


64 


154 


2 
1 


851 
127 


IJJ 


6 


31 


2 


331 


IJD 


22 


50 


2 
1 

1 
1 

1 
28 


535 

66 

66 

2 

24 

428 



RPS 



34 



110 



IPL and Buffer 
Load 



IPL 

(Note 1) 



12* 
6 



12 

24 



IJB 



20 161 



22 



Index Sequential 
Disk IOCS 



ISM** 
(Note 2) 



26* 



34 



IJH 



45 902 



2717 



Job Control 
Librarian 



JCL 
(Note 1) 



3* 
13 



4 
70 



IJB 



11 310 



245 



CORGZ 

MAINT 

CSERV 

DSERV (sorted) 

RSERV 

SSERV 

PSERV 



LBR 



(Note 1) 



9 
11 
1 
6 
1 
1 
1 



43 
63 

6 
13 

7 



IJB 


10 


162 


IJB 


19 


305 


IJB 


1 


24 


IJB 


2 


61 


IJB 


2 


29 


IJB 


2 


37 


IJB 


1 


25 



-+ 



Linkage Editor 



LNK 
(Note 1) 



20 



IJB 



87 



Magnetic Character 
Reader IOCS 



MCR** 
(Note 2) 



8* 



278 
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Relocatable | 


Source | 




| IBM J 


Core Image 


Library | 


Libra 


iry 


(Statement | 




(Program |- 






1 






j 


Library ( 








1 






1 


| Component 


j Number | 


Phases 


Blocks | Prefix 


Blocks I-- 












(5745-SC | 








Modules 


; (Books 


Blocks( 


h 


-+ +- 






-+- 






+- 




-J 


| Optical Character 


|OCR** | 


2* 


2 










5 




j Reader IOCS 




| 1287 


722 ( 


] 38 8 6 

L _ 


| (Note 2) | 

4- — X. 


2* 


2 


1 






4— 


6 


382| 
j 


r 


T T 






1 






T 




1 


| OLTEP 


(OLT | 

( (Note 2) | 


2* 
48 


2 
91 




IJZ 


50 


410 | 






| Configuration 




















| Data Sets 






(Note 3) | 












(Online Tests (OLTs) 






(Note 4) | 












L 


X X- 






1 






x 






r 


T T 






1 






T 






| Problem Deter- 


|PDA | 


15 


21 




IJB 


2 


45 ( 






mination Aids 




| PDA ID 








6* 


8 














| DUMPGEN 




1 


24 




IJB 


1 


93 | 






| LSERV 


| (Note 1) | 


1 


9 




IJB 


1 


20 ( 






| SDAID 




4 
2* 


25 
4 




IJB 


4 


64 | 






| Page Data Set Dump 




1 


12 




IJB 


1 


41 ( 






| (PDSDM) 




















| DOSVSDMP 




1 
1* 


32 
1 




IJB 


3 


138 | 






|PDZAP 


L X 


1 


2 


I 


IJB 


1 


28 | 
_ j. 




j 




T T 






1 






T 




1 


j Paper Tape IOCS 


(PTP** | 
( (Note 2) | 

-+ +- 


3* 


4 


-+- 






+- 


2 


593( 
j 


] POWER/VS 


jPWR | 

| (Note 2) | 

i j_~ 


45 

1* 


231 

1 


1 






J-- 


13 


753 | 
j 




_ T~ T 






1 






T 




1 


|QTAM 


IQTM j 
| (Note 2) ( 
J. _ X 


22* 


34 


1 


IJL 


109 


39 3 | 
4. 


79 


2013| 
j 




T ~ T 






1 






T 




1 


j Recovery Management 


|RMS | 


23 


23 














| Support 




JMCAR/CCH 






| (Note 1) | 
















j 






















j Supervisor Macros 


|SUP ( 
j (Note 1) | 


1* 


34 


















I Communication Macro 


3 j j 














50 
35 


525| 


] Generation Macros 




| Basic 


11,608| 


|TP 
















2 


290 | 


|DOC 


-X 4 












J 


2 


146] 
j 










1 












(Magnetic Tape IOCS 


] TAP * * 1 

| (Note 2) | 

-+ 4- 

]TPE | 


19* 


34 


-+- 


IJF 


18 


77 | 

+- 

17 | 


2 


994| 


(Tape ERP 


1 


4 


IJB 


1 






| (Note 1) | 


10* 


10 
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| 

| Component. 



j. 

! VSAM 



{Access Method 
servi ces 



j. _ 

jVTAM (incl. TOLTEP) 



IBM 

Program 
Number 
574 5-SC 



VSM 
(Note 2) 



Core Image Library 
Pnases 



Blocks 



15* 
31 

81 



17 
321 

496 



Relocatable 
Library 



Prefix Blocks 
Modules 



$$B 15 53 

IGG 57 754 

IKQ 92 949 

IDC 104 2275 



Source 
Statement 
Library 



Books Blocks 



26 



1602 



VTM 



J. _ 

I System Utility 

| Programs 

j Assign Alternate 

j Track Disk 

jAssign Alternate 

| Track Data Cell 

S BACKUP 

| Clear Disk 

| Clear Data Cell 

! Copy Disk tc Card 

(Copy Disk to Disk 

jCopy Disk or Data 

' Cell to Tape 

|Copy and Restore 

■ Diskette 

I Copy File and 

| Maintain Object 

! Module 

[ Deblock utility 

jfost Copy Disk Vol. 

j Initialize Disk 

j Initialize Data Cell 

j Initialize Tape 

(RESTORE 

\ Restore Card to Disk 

(Restore Tape to 

j DisJ: or Data Cell 

jjVTOC Display 

j Transients 

| Distribution Progiam 

i Supervisor (8K) 



181 
15* 



796 
16 



IJB 491 4552 

1ST 



44 



4680 



UTL 
(Note 2) 



42 



302 



41 



IJW 



IJW 



60 1122 



90 



26 


IJW 


6 


69 


7 


IJW 


1 


29 


8 I 


IJW 


4 


35 


7 | 


IJW 


4 


32 


11 | 


IJW 


3 


53 


13 


IJW 


3 


61 


11 | 


IJW 


3 


54 


19 | 


IJW 


1 


72 


48 | 


IJW 


1 


120 


1 7 | 


IJW 


2 


67 


18 | 


IJW 


5 


59 


28 | 


IJW 


5 


122 


15 | 


IJW 


5 


69 


5 1 


IJW 


2 


23 


16 | 


IJW 


1 


63 


7 | 


IJW 


2 


33 


8 j 


IJW 


2 


35 


6 I 


IJW 


4 


34 


1 1 









(Note 1) 



482 



522 



; Maintain System 
5 History 

; List Systen History 



UTS 



,1- 

\ ' 3800 J? r inter Support 



56 
12 



IKR 
1KB 



128 
63 | 



+" 



85 



[EB IMAGE 

GRF1xx-:x 

XTB 1 xxx J: 

SETPP? 



5748- 
C1-IMP 



1 

15 
47 






I5748- | 
JC1-PRT J 

Analysis Program-1 |AFC | 
;.. _L 1- 

* Ti anoi ents 

>* see "Compiler IOCS Modules" 
>** ':fi;fi ri can National Standard 



29 
35 
47 

14 



IEB 


4 


111 


GRF1 


15 


131 


XTB1 


47 


188 



! ijv 



70 



19 j IAQ 4 94 | 

J J 



275 
1 



H 



for the preassembled module names and usage. 
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18. Library Hfeguireiafents (Part 4 of 4) 



DCb/vS .-system Generation 



Notes ; 

1. See subsequent sections for further information on this component. 

2. See the relevant separate book module for further information on this component. 

3. This is the formula to calculate the number of core image library blocks needed for 
the configuration data sets: 

number of devices on system + 1 = number of blocks 
6 

4. The number of core image library blocks required for the Online Tests (OLTs) depends 
on the number of device types on the system and the number and size of the tests 
needed for these devices. This information is in the description that accompanies 
the tests. 
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Component Requirements 

IOCS Routines 

SOURCE S TATEMENT LIBRARY 

The following macros are shipped in the source statement library. 

Note : "Module 7: Compiler IOCS Modules", contains a list of preassembled modules 
required by system programs. 

File Definition Macros 



E.CDMOD 
E.DTMOD 
E.DTFBG 
E.DTFCD 



E.DTFCN 
E.DTFDI 
E.DTFEN 
E.DTFPH 



E.DTFFR 
E.DTFPT 
E.DTFSR 
E.PRMOD 



Imperative Macros 



Storage Bytes 





Basic 




|E.CCB 


16-24 




|E. CHECK 


8 




jE. CLOSE 


10 




|E. CLOSER 


14+10 


if any 


1E.CNTRL 


10-18 




|E.ERET 






|E.EXCP 


2-6 




| E.FEOV 


8-12 




|E.FEOVD 






jE.FREE 


8-12 




| E, GET 


8 




] E.LBRET 


2 




|E.NOTE 


12 




|E.OPEN 


10 




IE.OPENR 


14+10 


if any 


j E.POINTR 


8 




|E. POINTS 


8-12 




jE.POINTW 


8 




j E. PRTOV 


8 




J E . PUT 


8-12 




|E.READ 


8-36 


Note 5 


|E. RELEASE 






| E.RELSE 


8 




|E.SECTVAL 


10 




|E. SEOV 


10 




jE.TRUNC 


8-12 




|E.WAITF 


8-12 




|E. WRITE 


8-26 


Note 5 








Notes: 







register is specified 



register is specified 



i For Li t erals (Note 1) 

I 

I 

| + 4 

[+8 

| + 8 

|+4 

I 

1+0-4 
| + 4 

I 

1+0-4 

|+4 per symbolic name 

I 

|+4 

|+8 

|+8 

|+4 per symbolic name 

|+4 

| +4 per symbolic name 

j+4 per symbolic name 

|+4 

|+4 per symbolic name 

I 

|+4 per symbolic name 

j +4 per symbolic 

| + 8 

1+0-4 

1 + 0-4 

1+0-4 



| For Variables 


| Note 


2. 


|Note 


3. 


|Note 


4. 


(Note 


2. 


1 + 2 




| Note 


3. 


|Note 


4. 


|Note 


2. 


|Note 


2. 


| Note 


2. 


|Note 


2. 


|Note 


6. 


1 +3 




|Note 


3. 



1. Include the storage requirement for literals only once if the literal is used by more 
than one macro instruction. 

2. +4 per symbolic name, +2 per ordinary register notation* or +0 per special register 
notation. 

3. +4 per filename or +8 per register. 

4. +14 per filename or +8 per register. 

5. 2 bytes are required for BTAM. 

6. +38 No operands coded in register notation. 
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IOCS Macro Storage Requirements 



The storage required by the imperative macros may be determined by using the preceding 
figures with Figures 1-19 through 1-23. 

Note : Read-only modules are recommended for virtual programs (RDONLY=YES) . 

CDMOD (CARD MODULE) 













TYPEFLE 














L _ 
















| INPUT | 




OUTPUT 


T~ 


CMBNE 


j 








4-— ^- 4— 














r~ 

| RECFORM 


1 
1 


~ T 

I0AREA2 | 


T T T 
WORKA | 1442 | 2560*| 


1442 | 


2520 | 


T T 

2540|2560* or 5425J 


T 

1442 | 


2520 | 




I 




| 2520 | 5425 ] 
| 2540 | | 


2596 j 




-=* cr S> *=■ t 


J 




2540 | 




1 
1 






j For j 


1 

For 1 






1 




| 2501 | 1 






] Punch | Punch | 








1 




1 2596 | | 






|File | Inter-] 








1 




| 3505 | | 






| | pret | 








1 




| 3 52 5 | | 






1 |File | 








1 

-+- 

1 


-:-}- 


| 3881 | | 
x + + _ 

- | 104 | 154 | 


74 | 


+- 

80 | 


+ +- 

40 | 104 | 


+- 

96 | 


+- 

126 | 




| FIXUNB 


198 | 


| FIXUNB 


-f- 

1 

-4- 
1 


+- 

YES | 


+ + + - 

YES | 106 | 160 | 
x + f _ 

- j 136 | 176 | 


+~ 

116 | 

118 | 


+- 

122 I 

+- 

124 | 


+ +- 

84| 134 j 

82 | 140 | 


+- 

122 | 
+- 


+- 

154 | 

126 | 


226 | 


| FIXUNB 


198 | 


| FIXUNB 


I 


+- 

YES | 


+ + + _ 

YES | 138 | 186 | 


+- 

132 | 


+- 

138 | 


+ +- 

96 | 150 | 


X. 


+- 

154 | 


226 | 


| UNDEF 


-+- 
1 


+- 


+ + + . 


— +- 

112 | 


+- 

110 | 


+ +- 

73) 125 | 


+- 


+- 


_ j 


| UNDEF 


-f- 

1 
-+- 

1 


+- 

YES | 


+ + +- 

YES | - 1 - | 
+ + + _ 


+- 

124 | 

128 | 


+- 

132 j 

130 j 


+ +- 

92 j 142 | 

+ +- 

90 j 148 | 


+- 

+- 


X- 


- | 


| UNDEF 


- j 


| UNDEF 


-f- 

1 
-+- 

1 
-f- 

! 
-+- 

1 
-f- 

1 


+- 

YES j 

+- 

YES J 

YES | 


K 1 I K 1 t k! I 

w t i i m i i i h i 

CO 1 1 CO 1 1 CO 1 
1 1 1 1 t 1 1 1 t t 

1 1 < 1 1 1 1 1 1 1 

1 1 1 1 -t- 

1 1 1 1 1 


+- 

140 | 

126 I 

140 | 
+- 

154 | 

156 | 


+- 

146 | 
+- 

132 | 
+- 

146 j 
+- 

160 | 
+- 

162 | 


+ +- 

104| 154 j 
+ + . 

94j 142 J 

108 | 164 | 
+ +- 

118 | 166 | 
+ +- 

120 | 176 | 


+- 

+- 

+- 

f" 

+- 


i l i I i 1 i I i I 
1 l I I I 

1 1 1 1 1- 

l i l i l 


- | 


| VARUNB 


- | 


| VARUNB 


- | 


] VARUNB 


- | 


J VARUNB 


- 


I 


i 


_L 


X JL X 


j, _ 


j 


X X- 


X 


X 


j 




space req 


uired for associated f 


iles: 
















r 
FUNC= 


T 
| TYPFLE 


i 


















4- -^ 












T T 1 

| INPUT | OUTPUT [ 
















J- 4- 










RP 


T T 

1 48 1 


56 | 














RW 


-+ + 

1 56 | 


_ | 
















PW 


~h i 

1 - 1 
X X 


48 | 








RPW 


T T 
1 92 | 


64 | 














L 


J. J. 


j 







Figure 1-19. CONTROL — CDMCD Storage Requirements (Part 1 of 3) 
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Notes ; 

1. CTLCHR=YES or ASA; depending upon record format, number of I/O areas, and/or work 
area specifications: 

For YES,, a minimum of 8 to a maximum of 36 additional bytes are required. 

For ASA, a minimum of 28 to a maximum of 65 additional bytes are required. 

2. RDONLY=YES changes the size of the modules -50 to +50 bytes. In addition, the user's 
program must provide a 72-byte save area each time the module is reentered. 

3. Parts 2 and 3 of Figure 1-19 show the requirements for the other CDMOD options. The 
values selected must be added to the TYPEFLE value to determine the amount of storage 
needed. 



r t 

| CRDERR=RETRY 

y + 

| without IOAREA2 or WORKA | 
^ + 

| with either or both | 

L J. 



1 2520 | 2540 | 

+ 1 

+73 | +123 | 
+ -I 

+69 ] +119 | 

L J 



Figure 1-19. CONTROL — CDMOD Storage Requirements (Part 2 of 3) 



t 1 

3505/3525** 



CONTROL=YES 



1442 



2540 



2520 



2560* 
or 5425 



INPUT 



+26 



+ 82 



+ 30 



+ 44 



+ 94 



OUTPUT without WORKA 



+ 24 



+ 20 



+12 



+ 36 



+ 26 



OUTPUT with WORKA 



+24 



+ 32 



+ 12 



+ 20 



+ 38 



CMBND without WORKA 



+ 24 



+ 20 



+12 



CMBND with WORKA 



+ 32 



+ 32 



+12 



♦CONTROL may not be specified for input files associated with punch 
files on the 2560 or 5425. 
++CONTROL may not be specified for input files used as associated files 
on the 3525. 

j 



Figure 1-19. CONTROL — CDMOD Storage Requirements (Part 3 of 3) 

DTFCD (DEFINE THE FILE CARD ) 

TYPEFLE=INPUT requires 50 bytes. (72 bytes for single file for a 2560 or 5425, 56 bytes 
if ERROPT is specified for a 3 50 5 or 352 5,, 82 bytes plus the length of the card buffer if 
ASOCFLE is specified for a 2560 or 5425, 60 bytes if ASOCFLE is specified for a 3525.) 

TYPEFLE=CMBND requires 8 4 bytes. 

TYPEFLE=OUTPUT requires 48 bytes (64 bytes for single file for a 2560 or 5425, 69 bytes 
plus the length of the card buffer if ASOCFLE is specified for a 2560 or 5425, 52 bytes 
if ASOCFLE is specified for a 3525, 152 bytes if FUNC=I is specified for a 2560 or 5425, 
128 bytes if FUNC=I is specified for a 3525). 

CRDERR=RETRY (2540 only) requires an additional 88 bytes. 

DEVICE=2520 requires 8 additional bytes. 
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DIMOD (DEVICE INDEPENDENT SYSTEM UNITS MODULES) 

r t t t 1 

I I Basic | | | 

J TYPEFLE= | Module | IOAREA2=YES | RPS Version of Logic Module | 

j. 1 x x ^ 

| INPUT | 454 | +112 | 534 | 

,. X + + 4 

j OUTPUT J 903 J +152 | 1021 j 

J. X X X 1 

|RDONLY=YES changes the size of the module -70 to +70 bytes. In addition, the | 
| user's program roust provide a 72-byte save area each time the module is reentered.) 
| RPS versions of the logic models support all other options for each TYPFLE. | 
| j j Specif ying TRC=YES adds another 256 bytes to the size of the module. j 

i J 

Figure 1-20. DIMOD Storage Requirements 

DTFDI (DEFINE THE FILE DEVICE INDEPE ND ENT SYSTEM UNI TS) 

The table requirement is 240 bytes. 

PRMOD (PRINTER MODULE) 



t t t t t r r 

111 I |CTLCHR= | | 

I BASIC | | | |^ T ^ | 

RECFORM= j MODULE | WORKA=YES | IOAREA2=YES j PRINTOV |ASA | YES | CONTROL=YES | ERROPT=YES 
| (2) | | | (3) | | | (4) | (1) 





"+- 




-+-- 




"+— 




— f" 




"+ + +— 




X- 




FIXUNB 


1 
X . 


72 


1 

L _ 


+ 6 


1 
_ i 


+ 24 


1 

X 


+ 34 


|+128| | 
_ X - i X 


+ 40 


1 

x 


+ 68 




— T 




— r 




T 




T 




T 1 T 




— T 




UNDEF 


1 

-4- 


102 


1 
-+- 


+ 22 


1 


+ 12 


1 
__X_ 


+ 34 


|+132|+4 | 

--+ — T — +— 


+40 


1 
X_ 


+ 68 


VARUNB 


1 
_ j. . 


136 


1 

X - 


+14 


1 

- X 


+12 


1 

x_ 


+ 34 


|+124|-4 j 

_ X X X 


+ 40 


1 
X- 


+ 68 



Note : RDONLY=YES changes the size of the module -50 to +50 bytes. In addition, 
the user's program must provide a 72-byte save area each time the module is 
reentered. Specifying TRC=YES increases the size of the module by an additional 
102 to 158 bytes, depending on the options chosen. 

(1) If ERROPT=YES is specified, then DEVICE=3211 must also be specified- For a 
352 5 add 22 bytes, instead of 68, for ERROPT. 

(2) For the 2560 and 5425, the sizes are 166 bytes for FIXUNB, 190 bytes for 
UNDEF, 206 bytes for VARUNB. For the 3525, add from 52 to 72 bytes to the 
size of the basic module, depending on the type of associated file specified. 

(3) For the 3525 add from 34 to 58 bytes. 

(4) For the 352 5 add from 40 to 160 bytes. 



Figure 1-21- CONTROL — PRMOD Storage Requirements 



DTFPR (DEFINE THE FILE PRINTER) 



The table requirement is 4 8 bytes or 52 bytes if ERROPT is specified for the 3211 printer 
or, if ASOCFLE is specified, for the 3525 card punch. For the 2560 the requirement is 72 
bytes for a single file or 64 bytes for an associated file; for the 5 425 the requirement 
is 56 bytes for either a single or an associated file. 
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DTFPH (DEFINE THE PHYSICAL IOCS) 



Device 



h 

| Tape 



■t 1 

|Size 



101 



y 

jDASD MOUNTED=ALL 



10 



j. 

JDASD MOUNTEE=S INGLE 



81 



3510 MOUNTED=SINGLE 



I 

h x. 

J No module is required for this macro 
| instruction. 

L 

Figure 1-22. CONTROL — DTFPH Storage 
Requirements 



81 



DTFCN 


(DEFINE 


THE 


FILE 


CONSOLE) 


r 






I 

1 
-+ 


TYPEFLE= 
._ T _ 1 



|RECFORM= |WORKA= | INPUT/ | OUTPUT | CMBND| 
| J j OUTPUT I only | | 

jFIXUNB | - | 91 | 60 | 111 

|FIXUNB | YES | 150 | 90 | 252 

|UNDEF | - | 156 | 111 | - 

|UNDEF | YES | 262 | 168 |- 

X x x x 



h x 

| No module is required for this macro | 

{instruction. | 

I J 

Figure 1-23. CONTROL — DTFCN Storage 
Requirements 



DTFSR (DEFINE THE FILE SERIAL DEVICE) 

When a DTFSR is assembled, it generates 
both a table and a module. For example, if 
DTFSR is used for a printer, a table and a 
module are generated just as though DTFPR 
and PRMOD were used. To determine the 
storage requirements for DTFSR, add the 
table and the module requirements for the 
appropriate device type, such as 18 bytes 
(DTFPR) and n bytes (PRMOD) for a printer. 



System Directory list and SVA Loading 



• SDL loads a set of selected system 
phases, but no RPS or VSAM phases. 

• RPS loads the same phases as procedure 
SDL plus RPS phases. 

• VSAMSVA loads the same phases as 
procedure SDL plus VSAM phases. 

• VSAMRPS loads the same phases as 
procedure SDL plus RPS and VSAM. 

The statements that make up procedures SDL 
and RPS are listed under "SDL Considerations' 
and "RPS Considerations", respectively, 
below. Those of VSAMSVA and VSAMRPS are 
listed in Module 17 of this manual, under 
"Loading VSAM phases into the SVA". 

If a 3800 Printing Subsystem is to be used, 

names IJVSPRDV and IJDPR3 must be added to 

the SDL. They are not in any of the IBM- 
supplied lists. 



SDL Considerations 



Procedure SDL builds a system directory 
list for systems generated without VSAM and 
RPS support. It consists of the following 
transients, phases, and statements: 



SET SDL=CREATE 

$$BCLOSE 

$$BCL0S2 

$$BCLOS3 

$$BCLOS1 

$$BEOJ 

$$BE0JS1 

$$BEOJ1 

$$BEOJ7 

$$BOCP01 

$$BOCP03 

$$BOFLPT 

$$BOPEN 

$$BOPEND 

$$BOPENR 

$$BOPEN0 

$$BOPENl 

$$BOPEN3 

$$BOPEN1 

$$BOPBM5 

$$B0PEM6 

$$BOPIGN 

$$B0SDC1 

$$BOSDC3 

$$B0SDI1 

$$BOSDI2 

$$BOSDI1 

$$BOSDOl 



$$B0SDO2 

$$BOSD03 

$$BOSD01 

$$BOSD08 

$$BOSD09 

$$B0SDW1 

$$BOSDW2 

$$BOSD00 

$$BOSD01 

$$BOSD02 

$$ BOS DO 3 

$$BOSD04 

$$BOSD05 

$$ BOS 006 

$$BOSIGN 

$$BSETL 

$$BSETL1 

$$BSETL2 

$JOBCTLA 

$JOBCTLE 

$JOBCTLN 

$JOEACCT» SVA 

$JOBEXIT,SVA 

$LIBSTAT,SVA 

$MAINDIR,SVA 

/* 

/♦ 



The system procedure library contains the 
procedures SDL, RPS, VSAMSVA , and VSAMRPS 
to build system directory lists and to load 
IBM-supplied phases into the SVA. 
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RPS Considerations 



Procedure EPS builds a system directory 
list for systems generated with EPS 
support. This procedure consists of the 
statements given under "SDL Considerations" 
(excluding the /* and /♦) plus the 
following: 

IJGCYCStf,S¥A 

IJGCYC»B r S"/A 

1JGFBCHB,SVA 

I3GFtfCtfB,SVA 

IJGFXC«B,SVA 

IJGFJCCiia,SVA 

IJGP¥CSB,S¥A 

IJGQtfCiiB,S?A 

IJGQXCSfB,SYA 

IJGRICS»B,S/A 

IJGSYC«B,S¥A 

IJGTWNCT,5¥A 

iJGUrfC«a,S*A 

IJGUXC«iB,SV~A 

IJGVWCwB,S¥A 

IJG¥XCWfl,SiTA 

IJHAVBBF,SVA 

IJHAVBBS,SVA 

IJHAVBCF,SVA 

IJHAVBCS,SVA 

IJHAVGBF,SVA 

IJHAVGBS,SVA 

IJHAVGCF,SVA 

IJHAVGCS,SVA 

IJHZXGZS,SVA 

IJIBWEHW,SVA 

IJlFlifiHk,SVA 

IJISWEHW,SVA 

IJlVWEHi,S.¥ik 

IJJCVA1N,SVA 

IJJCVDV,SVA 

IJJCVDO,SVA 

IJJFVBIC,SVA 

IJJFVIIC,SVA 

/* 

/♦ 



51£ETI0N OF SPS SUPPORT 

If RPS support will never be used in any 
supervisor, the following core image library 
phases may be deleted: 

IJGCYCMB 

IJGCYCWB 

IJGFWCMB 

IJGFWCWB 

IJGFXCMB 

IJGFXCWB 

IJGPYCWB 

IJGQWCWB 

IJGVXCWB 

IJGRYCWB 

IJGSYCWE 

IJGTWNCT 

IJGUWCWB 

IJGUXCWB 

IJGVWCWB 

IJGQXCWB 

IJHAVEBF 

I JHAVBB S 

IJHAVBCF 

IJHAVBCS 

IJHAVGBF 

IJHAVGBS 

IJHAVGCF 

IJHAVGCS 

IJHZXGZS 

IJIBWEHW 

IJIFWEHVJ 

IJISWEHW 

IJIVWEHW 

IJJCVA1N 

IJJCVDV 

IJJCVEO 

IJJFVBIC 

IJJFVIIC 
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2S5^ItQ*2IHG MODULES IN THJ 5VA 

Any or all of the following modules may be pre-loaded into the SVA to improve 
performance. When checkpointing with RPS in the system it is a requirement that any RPS 
logic module phases that will be used by the program be pre-loaded. Any access method 
may be used when all of the following phases are pre-loaded. For information on 
reserving storage for EPS, refer to the DOS/VS System Management Guide. 













I Number I 


Phase Name] Access 


He t hod 


| Function 


I of Bytes j 


IJGCXCHB 


Seguem 


tial Disk 


| Fixed length, update, T8UNCS 


1550 | 


IJGCYCWB 






[Fixed length, update 




| 1406 J 


IJGFSCMB 






| Fixed length, input, TRUNCS • 


1078 | 


IJGFWCKB 






| Fixed length, input 




904 I 


IJGFXCHB 






[Fixed length, output, TRUNCS 


1252 | 


IJGFXCHB 






| Fixed length, output 




I 1032 J 


IJGPYCtfB 






I Spanned record, update 




I 3302 | 


IJGQHCWB 






| Spanned record, input 




1428 | 


IJGQXCWB 






[Spanned record, output 




2790 | 


IJGRYCWB 






| Undefined, update 




1518 | 


IJGSYCWB 






[Variable length, update, 


hold 


1778 | 


IJGTWNCT 






| Work file 




1992 | 


IJGUWCHB 






[Undefined, input 




928 | 


IJGUXCtfB 






[Undefined, output 




1090 | 


IJGVHCSB 






[Variable length, input 




998 | 


IJGVXCWB 






[variable length, output 




1568 | 


IJHAVBBF 


IISAM 




| HOLD, CORD ATA 




7744 J 


IJHAVBBS 






| HOLD, no CORDATA 




7234 | 


IJHAVBCF 






| NO HOLD, CORDATA 




7330 | 


IJHAVBCS 






| NO HOLD, no CORDATA 




6812 | 


IJHAVGBF 






[Two I/O areas, HOLD, CORDATA 


7336 | 


IJHAVGBS 






\tvo I/O areas, HOLD, no 


CORDATA 


6822 | 


IJHAVGCF 






[Two I/O areas, no HOLD, 


CORDATA 


6976 | 


IJHAVGCS 






[Two I/O areas, no HOLD, 


no CORDATA 


646 2 | 


IJHZXGZS 






| Load 




1556 I 


IJIBWEHW 


Direct 


Accesss 


[Undefined record 




2202 | 


IJIFKEHH 






[Fixed length 




1994 J 


IJISHEHH 






I Spanned record 




5110 | 


IJIVWEHW j 






Variable length 




2140 | 


IJJCVA1N j 


Device 


Independent 


ASCII 




887 | 


IJJCVDV 


(System) 


I I/O pointer 




751 | 


IJJCVDO 






I Fixed area I/O 




847 | 


IJJFVBIC 


Device 


Independent 


I Output 




1029 | 


IJJFVIIC 


(User) 




llnput 




550 | 



i.--— ~ -_-_.— _ — _ — --_».-- — .___- — -__ •—-.-- — --—._- J 

Phases that are not used by the checkpointing program do not have to be pre-loaded into 
the SVA. 

Examples: 

1. If the program does not use ISAH, none of the nine ISAH phases needs to be 

pre-loaded. 

2. If ASCII=XES is not specified in the SOPVR macro at system generation time, IJJCVA1N 
need not be pre-loaded. 
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IPL and Buffer Load 



Link-Edit Statements 



IPL 



CORE IMAGE LIBRARY 

Transients 

| $$A$CDL0 (optinal provided by the user) 
$$A$IPL1 
$$A$IPL2 

Phases 

$IPLRT2 
$IPLRT3 
$IPLRT4 
$IPLRT5 



RELOCATABLE LIBRARY 

Module 

IJBIPL 

Link-Edit St a tements 

INCLUDE IJBIPL 
// EXEC LNKEDT 

Buffer Load (1403U Printer) 

CORE IMAGE LIERARY 

It is your responsibility to link-edit into 
the core image library the modules required 
for later use in LUCB and UCB job control 

statements. 

RELOCATABLE LIBRARY 

Modules 

IJBTRAN 
IJBTRGN 
IJBTRONA 
IJBTRPAN 

IJBTRPHN 

IJBTRPN 

IJBTRQNC 

IJBTRQN 

IJBTRRN 

IJBTRSN 

IJBTRTN 

IJBTRYN 

IJBTRALA 



PHASE phasename,+0 
INCLUDE IJBTRXXX 
// EXEC LNKEDT 

where xxx is a two or three character 
identifier of the train type on your 1403U. 



| Buffer Load (3203 Printer Model 1 and 2) 



CORE IMAGE LIBRARY 



Transients (Required for IPL) 

$$BFCB3 

$$BUCB3 

$$BUFLDR 

$$BUFLD1 

$$BUFLD2 

Phase s 

SYSBUFLD 
SYSBUFF1 



RELOCATABLE LIBRARY 

Modules 

IJBSEUEF 

IJBSBUF1 

IJBTRAN 

IJBTRGN 

IJBTRONA 

IJBTRPAN 

IJBTRPHN 

IJBTRPN 

IJBTRQNC 

IJBTRQN 

IJBTRRN 

IJBTRSN 

IJBTRTN 

IJBTRYN 

IJBTRALA 

Link-E d it S tatements 

PHASE $$EUCB3,+0 
INCLUDE IJBTRXXX 
// EXEC LNKEDT 

where xxx is a two or three character 
identifier of the train type on your 3203 
printer other than the AN supplied in the 
core image library. 

PHASE SYSBUFLD, +0 
INCLUDE IJBSBUFF 
PHASE SYSEUFFl,+0 
INCLUDE IJBSBUF1 
// EXEC LNKEDT 
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Buffer Load (3203-4 Printer) 



Buffer Load (3211 Printer) 



CORE IMAGE LIBRARY 



Transients (Required for IPL) 

$$BFCB00 
$$BUCBO0 
$$BUFLDR 
$$BUFLD1 
$$BUFLD2 



C ORE IMAGE LIBRARY 

Transients (Required for IPL if 3211 is 

present) 

$$BFCB 

$$BUCB 

$$BUFLDR 

$$BUFLD1 

$$BUFLD2 

RELOCATABLE LIBRARY 



Phases 

SYSBUFLD 
SYSBUFF1 

OLOCATABIjE LIBRARY 

Modules 

IJBSBUFF 

IJBSBUF1 

IJBTVAN 

IJBTVGN 

IJBTVOAA 

IJBTVOAB 

IJBTVODA 

IJBTVONA 

IJBTVPAN 

IJBTVPHN 

IJBTVPN 

IJBTVQNC 

IJBTVQN 

IJBTVRN 

IJBTVSN 

IJBTVTN 

IJBTVYN 

IJBTVALA 



Modules 

IJBSEUFF 
IJBSBUF1 
IJBTRAll 
IJBTRG11 
IJBTRH11 
IJBTRP11 
IJBTRT11 

Link-Edit Statements 

PHASE $$BUCB,+0 
INCLUDE IJBTRxnn 
// EXEC LNKEDT 

where xnn is the train on your 3211 printer 
other than the All supplied in the core 
image library (transient $$BUCB) . 

PHASE SYSBUFLD, +0 
INCLUDE IJESBUFF 
PHASE SYSEUFFl,+0 
INCLUDE IJBSBUF1 
// EXEC LNKEDT 



Buffer Load (5203 Printer) 



Linjfcr. Efl it Statements 

PHASE $$BUCB0O,+0 
INCLUDE IJBTVxxx 
// EXEC LNKEDT 

where xxx is a two or three character 
identifier of the train type on your 
3203-4 printer other than the AN supplied 
in the core image library. 

PHASE SYSBUFLD ,+0 
INCLUDE IJBSBUFF 
PHASE SYSBUFFl,+0 
INCLUDE IJBSBUF1 
// EXEC LNKEDT 



CORE IMAGE LIBRARY 



Transients (Required for IPL) 

$$BFCB5 

$$BUCB5 (see Note) 

$$BUFLDR 

$$BUFLD1 

$$BUFLD2 

Note: This transient is not required for 
IPL when the UCS feature is not present. 

Phase s 

SYSBUFLD 
SYSBUFF1 
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RELOCATABL E LIBRARY 

Modules 

IJBSBUFF 

IJBSBUF1 

IJBTRAN 

IJBTRGN 

IJBTRPN 

Link -Ed it S tatements 

PHASE $$BUCB5,+0 
INCLUDE IJBTRxx 
// EXEC LNKEDT 

where xx is the train type on your 5203U 
printer other than the AN supplied in the 
core image library. 

PHASE SYSBUFLD,+0 
INCLUDE IJBSBUFF 
PHASE SYSBUFFl,+0 
INCLUDE IJBSBUF1 
// EXEC LNKEDT 

3800 Printing Subsystem Support 

SETPRT (SET 3800 PRINTING SUBSYSTEM 
PARAMETERS ) 

CORE IMAGE LIBRARY 

Transients 

$$BUFLDR 
$$BUFLD1 
$$BUFLD2 

Phase (Required if 3800 is present) 

IJVSPRDV 



RELOCATABLE LIBRARY 

Modules 

IJVSPRCM 
IJVSPRDV 
IJVSPRIO 
IJVSPR01 
IJVSPR02 
IJVSPR03 

Source Statement Library 

E.QSETPRT 
E. SETPRT 
E.SPLIST 

Link-Edit Statements 

For a list of the link-edit statements 
that are a part of the DOS/VS IBM 3800 
Printing Subsystem Independent Component 
Release (ICR) , see the link book in the 
"Program Directory" that comes with the 
ICR. 



IEBIMAGE (UTILITY FOR THE 3800) 

CORE IMAGE LIBRARY 

Phase 

IEBIMAGE 

RELOCATABLE LIBRARY 
Modules 

IEBIMAGE 
IEBIMSGS 
IEBIOBJT 
IEBISCAN 



GRFIxxxx (IBM-SUPPLIED GRAPHIC CHARACTER 
MODIFICATION PHASES) 

CORE IMAGE LIBRARY 

Phases 



GRF1 
GRF1 
GRF1 
GRF1 
GRF1 
GRF1 
GRF1 
GRF1 
GRF1 
GRF1 
GRF1 
GRF1 
GRF1 
GRF1 
GRF1 



IGSC 
IGS0 
IGS2 
IGS5 
IGUC 
IGU0 
IGU2 
IGU5 
IOSA 
IOSB 
ISP1 
ITS1 
ITS2 
ITU1 
ITU2 



RELOCATABLE LIBRARY 



Modules 



The module names of the GRFIxxxx modules 
are identical to the 1 5 phase names 
shown . 



XTBlxxxx (IBM-SUPPLIED CHARACTER 
ARRANGEMENT TABLEST 

CORE IMAGE LIBRARY 

Phases 

XTB1AN 

XTB1AOA 

XTB1AOD 

XTB1AON 

XTB1A11 

XTB1BOA 

XTB1BON 

XTB1FM10 

XTB1FM12 
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XTB1FM15 

XTB1GFC 

XTB1GF10 

XTB1GF12 

XTB1GF15 

XTB1GN 

XTB1GSC 

XTB1GS10 

XTB1GS12 

XTB1GS15 

XTB1GUC 

XTB1GU10 

XTB1GU12 

XTB1GU15 

XTB1G11 

XTB1HN 

XTB1H11 

XTB1KN1 

XTB10AA 

XTB10AB 

XTB10DA 

XTB10NA 

XTB10NB 

XTB1PCAN 

XTB1PCHN 

XTB1PN 

XTB1P11 

XTB1QN 

XTB1QNC 

XTB1RN 

XTB1SN 

XTB1TN 

XTB1TU10 

XTB1T11 

XTB1XN 

XTB 1 YN 

XTB12773 

XTB12774 



RELOCATABLE LIBRARY 



$JOBCTLG 

$JOBCTLJ 

$JOBCTLK 

$JOBCTLM 

$JOBCTLN * 

$JOEEXIT 

$SYSOPEN ** 

* Required for Job Accounting Interface 
♦♦Only present in core image library. Not 
part of JCL proper. 

RELOCATABLE LIBRARY 

Modules 

$JOBACCT 

IJBJC 

IJBJCB 

IJBJC 1 

IJBJC2 

IJBJC3 

IJBJC4 

IJBJC 5 

IJBJC6 

IJBJC7 

IJBJCB (Job Accounting Interface) 

IJBJC 9 

Link- Edit Statements 

INCLUDE IJBJC 
// EXEC LNKEDT 

INCLUDE $JOBACCT 
// EXEC LNKEDT 



Linkage Editor 



Modules 

The module names of the XTBlxxxx modules 
are identical to the 47 phase names shown, 



CORE IMAGE LIBRARY 



Phases 



$ LNKEDT 



Job Control 



RELOCATABLE LIBRARY 



CORE IMAGE LIBRARY 



Transients 



$$BJCOPT 
$$BJCOPl 
$$BLSTIO 



Modules 

IJBLE1 

Link-Edit Statements 

INCLUDE IJBLE1 
// EXEC LNKEDT 



Phases 

$JOBACCT 
$JOECTLA 
$JOBCTLB 
$JOBCTLD 
$JCBCTLE 
$JOBCTLF 



WORK FILE REQUIREMENTS FOR LINKAGE EDITOR 

This section contains information for 
determining the work file requirements for 
the linkage editor and assembler when the 
work file is on as IBM DASD other than 
2311. 
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IJBMDS 
IJBMDU 
IJBMIN 
IJBHIO 
IJBMUP 
IJBSL2 

Link-Edit Statem en ts 

INLCUDE IJBSL2 
// EXEC LNKEDT 

INCLUDE 1JBLBI0 
// EXEC LNKEDT 

INCLUDE IJBLBI1 
// EXEC LNKEDT 



CSERV 

Core Image Library 

Phage 

CSE8V 

Relocatable Library 

Module 

IJBLBP 

Link-Edit Stateaents 

INCLUDE IJBLBP 
// EXEC LNKEDT 

DSERV 

Core -Jl^se Litrar^ 

Phases 

DSEEV 

DSERV1 

DSEEV2 

DSERV3 

DSEBVft 

DSERV5 

DSERV6 

Relocatable Library 

Hodu^es 

IJBSL1 

Link-Edit Sta tements 

INCLODE IJESL1 
// EXEC LNKEDT 



PSERV 

Core la age Library 

Phase 

PSERV 

Relocatable Library 

Module 

IJB5L6 

Lin k^ Edit Statements 

INCLODE IJBSL6 
// EXEC LNKEDT 

RSERV 

Core IlM.§ Library 

Phase 

ESEBV 

Relocatable Library 

Modules 

IJBLBC 
IJBSL3 

LinKrMii Statements 

INCLUDE IJBSL3 
// EXEC LNKEDT 

SSERV 

Core Image Library 

Phase 

SSERV 

Relocatable Library 

Modules 

IJBLBC 
IJBSL4 

kink-Edit Statements 

INCLUDE IJBSL4 
// EXEC LNKEDT 
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Supervisor Nucleus - 5745-SC-SUP 



CORE IMAGE LIBRARY 



r 

1 Phase j 


Nufflber 


I Number of 




| Naae | 


of 


Library 


Remarks 




Phases 


Blocks 




| $$A$SUP0 | 




3H | 


Required for systea generation 64K Model 115 CPD 


J $$A$S0P1 1 




48 


Standard Supervisor 


| $$A$SUP2 | 




| 52 




| $$A$SUP3 | 




70 




| $$A$SUP4 | 




70 




i $$A$S0P5 i 




82 




| $$A$SUP6 | 




96 
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CONFIGURATIO N OF SUPERVISOR $$A$SUP1 

Figure 1-24 represents the parameters and their specification of the standard default 
supervisor for the 3330 resident system (generated devices can be adjusted at IPL-tims 
using ADD and DELETE commands) . 



MACRO 
GEN SUP VR 

$$A$SUP1 = POWER/VS SUPERVISOR, WITH RELLDR, VSIZE=512 

TITLE 'DOS/VS SUPERVISOR 1, SYSRES=333 0, MOD=125, NPARTS=2 ' 

SUPVR NPARTS=2 , POWER=YES , CHAN=YES , RMS=YES , PHO= YES , ID=1 

CONFG MODEL=125 

STDJC 

FOPT OLTEP=NO, SYSFIL=YES, RELLDR=YES, ECPREAL=YES , 

PFIX=YES 
PIOCS BMPX=YES,TAPE=7,DISK= (3330,3340,3350) 
VSTAB KSIZE=256K,VSIZE=512K,SVA=<6 4K,0K) 
ALLOC F1=152K 
ALLOCR F1R=16K 
IOTAB JIB=20,EGPGR=40,F1PGR=10,D3 420=2, 02314=2,0 3 330=2, 

D3340=2,D3410=2,D3520=2,IODEV=20 
DVCGEN CHUN=X'00D' DVCTYP=2560 



DVCGEN CHUN=X'00E* 
DVCGEN CHUN=X t 01F' 
DVCGEN CHUN=X lt 04C J 
DVCGEN CHUN=X*0MD' 
DVCGEN CHUN=X'160' 
DVCGEN CHUN=X*161' 
DVCGEN CHUN=X , 162 I 
DVCGEN CHUN=X'16 3 1 
DVCGEN CHUN=X*28 0' 
DVCGEN CHUN=X'281' 
ASSGN SYSIOGjX'OlF 
ASSGN SYSREC,X'160 
ASSGN SYSRDR,X , 04C 
ASSGN SYSIPT,X'0 4C 
ASSGN SYSPCH, X'04D 
ASSGN SYSLST,X f 00E 
ASSGN SYSLNK, X*161 
ASSGN SYS001,X'161 
ASSGN SYS002,X , 161 
ASSGN SYS003,X'161 
ASSGN SYS004,X'161 



DVCTYP=3203 

DVCTYP=125D 

DVCTYP=3505 

DVCTYP=3525P 

DVCTYP=3340 

DVCTYP=3340 

DVCTYP=334 

DVCTYP=33M0 

DVCTYP=3410T9 

DVCTYP=3410T9 



,BG 
,BG 
»BG 

,BG 
,BG 



DPD UNIT=X'160' ,VOLID=SYSRES,CYL=605 

SEND 



MEND 

GEN SUPVR 

END 

/* 

/& 



Figure 1-24. Supervisor $$A$SUP1 — Supplied by IBM as Standard 
Default Supervisor for DOS/VS 
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HOW TO DISPLAY AND COMPILE SUPERVISOR S 

All source coding of the IBM-supplied supervisors is contained in the A.Sublibrary of the 
system source statement library under the names SUPO through SUP6. To obtain a printout, 
execute: 

// JOB SSERV 
// EXEC SSERV 

DSPLY A.SUPO, A.SUP1, f A.SUP6 

/* 
/& 

To change the contents (in order to tailor a given supervisor) use the program MAINT. To 
compile the tailored supervisor, use: 

// JOB ASSEMBLE 
// OPTION DECK 
// EXEC ASSEMELY 

COPY SUPx 

END 
/* 
/g 

Supervisor Generation Macros (Basic) 

E. ALLOC 

E.ALLOCR 

E.ASSGN 

E . BDYBOX 

E.CONFG 

E.DISP 

E.DPD 

E . DVCGEN 

E.FOPT 

E.IOINTER 

E.IOTAB 

E.ISTAVT 

E . MAPCOMR 

E.MAPERPIB 

E.MCRAS 

E.MAPLOWC 

E.MAPPUB2 

E.PIOCS 

E.SEND 

E . SGAM 

E.SGCCWT 

E.SGDFCH 

E.SGDSK 

E.SGEND 

E.SGPMAIN 

E.SGPOPT 

E.SGPSUB 

E.SGSCVRT 

E.SGSVC 

E.SGSVCX 

E.SMICR 

E.STDJC 

E . SUPVR 

E-SYSIO 

E.VSTAB 

For a detailed description of storage requirements, refer to "Supervisor Storage 
Requirements", 
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Teleprocessing 

E.IJLQDSCT 
E.IJLQTSVC 

Note ; These macros are part of the QTAM program but are required to generate a QTAM 
supervisor. 

Display Operator Conso le Sup port 

E.CRTGEN 
E.CRTSAV 

Note ; These macros are required to generate a supervisor with Display Operator Console 
support. 

POWER/VS 



Macros 

E.IPW$DPA 
E.IPW$DPD 
E.IPW$DDE 

These macros are part of the POHEB/VS program. They are required to generate a supervisor 
with support of POWEB/¥S (POSEB^YES specified in the SUPVB aacro instruction) . 

MCAR/CCH (RMS) 



CORE IMAGE LIBRARY 



Transients 

$$ABERA1' 

$$ABERA2 

$$ABERA3 

$$ABERA4 

$$ABERA5 

$$ABERA6 

$$ABERA7 

$$ABERRJ 

$$ABERRP 

$$AEERRQ 

$$BCCHHR 

$$RAST00 

$$RAST01 

$$RAST02 

$$RAST03 

$$RAST0U 

$$RAST05 

$$RAST06 

$$RAST08 

$$RAST09 

$$RAST10 

$$RAST11 

$$RAST13 



RMSR 



Statistical counter update (non-tape) 

3211 RMSR 

3211 RMSR 

t scans Cl-directory for all $$RASTnn phases 

CCH and Initial MCAR analysis 

Channel and machine check record builder and recorder 

Channel check analysis 

EFL and MCAR analysis 

Unit record channel check ERP 

Unit record channel check ERP 

3505 and 3525 channel check handler ERP 

Machine check and channel check record writer 

Partition reallocation 

ERP message writer 

Message writer 

Partition reallocation 
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252I£E EBBOR ROVTIMBS k¥D pPBW^CfrOSg PH*§«S FOB pOg/V? 

The following is a list of required system control and coarmon IOCS transients. Type A 
transient routines (device error routines) have the prefix $$A. ($ is an alphabetic 
character in System/370.) Type B transient routines (OFEN« CLOSE. CHKPT, and so on) have 
the prefix $$B. 

$$A$SUP1 Supervisor 

$$ABERAA Statistical counter update (tape) 

$$ABERAB Tape ERP 

$$ABERAC Tape ERP 

$$AEERAD Tape ERP 

$$ABERAE Tape ERP 

$$ABERAF Tape ERP 

$$ABERAG Tape ERP 

$$ABERAH Tape ERP 

$$ABERAI Tape ERP 

$$ABERAN 3886 OCR ERP 

$$ABE£AO 3895 ERP Phase 1 

$$ABEBAP 3895 EBP Phase 2 

SSABEBAQ 3895 OBB record builder 

$*ABEBAB 3895 HDB record builder 

$$ABERA1-$$ABERA7 RMSR 

$$ABERBA 3800 error recovery 

$$ABERBC 3800 MDR record writer 

$$ABERBD 3800 OBR record writer 

$$ABERP1-$$AEERP9 BTAM ERP 

$$ABERRA Error recovery monitor 

$$ABERRB Disk ERP 

$$ABERRC Setup 2560 restart information 

$$ABERRD 2560/ 5U25 ERP repositioning 

$$ABERRE Setup 512 5 restart information 

$$ABERRF PRT1 ERP 

$$ABERRG 3504/3505 Card reader and 3525 card punch ERP 

$$ABERRH 22 U 5 ERP (Kanji printer support) 

$$ABERRI 2195 tape cartridge reader ERP 

$$ABERRJ Statistical counter update (non-tape) 

$$ABERRK RMSR message writer 

$$ABERRL ERP message writer 

$$ABERRM ERP message writer 

$$ABERRN ERP message writer 

$$ABERRO ERP message writer 

$$ABERRP PRT1 RMSR 

$$ABERRQ PRT1 RMSR 

$$ABERRR 2560 ERP 

$$ABERRS MICR ERP 

$$ABERRT 1287/1288 OCR ERP 

$$ABERRU 1017/1018 Paper tape ERP 

$$ABERRV 2671 Paper tape ERP 

$$ABERRW 1052 Console printer keyboard ERP 

$$ABERRX Unit record error recovery 

$$ABERRY Unit record ERP 

$$ABERRZ Physical attention routine 

$$ABERR1 2311 Data cell ERP 

$$ABERR2 2321 Data cell ERP 

$$ABERR3 2321 Data cell ERP 

$$ABERR4 2321 Data cell ERP 

$$ABERR5 2321 Data cell ERP 

$$ABERR7 3540 Diskette ERP 

$$ABERZ1 Physical attention routine 

$$ABERZ2 Physical attention routine 

$$BATTF0 FCB load initiation (macro invoked) 

$$BATTF1 LFCB Command processor 2 

$$BATTF2 LFCB Macro execution CPRT1) 

$$BATTF3 LFCB Macro execution (non-PRTl printers with PCB, excluding the 3800) 

$$BATTFU FCB Load execution (non-PRTl printers with FCB, excluding the 3800) 

$$BATTF5 FCB Load execution (PRTl) 
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$$BATTNA 
$$BATTNB 
$$BATTNC 
$$BATTND 
$$BATTNE 
$$BATTNF 
$$BATTNG 
$$BATTNH 
$$BATTNQ 
$$BATTNR 
$$BATTNS 
$$BATTNT 
$$BATTNU 
$$BATTNV 
$$BATTNW 
$$BATTNX 
$$BATTN¥ 
$$BATTNZ 
$$BATTN2 
$$BATTN3 
$$BATTN5 
$$BATTN8 
$$BATTN9 
$$BATTU1 
$$BATTU2 
$$BCCPT1 
$$BCE0V1 
$$BCHKPD 
$$BCHKPE 
$$BCHKPF 

I $$BCHKPG 
$$BCHKPT 
$$BCHKP2 

| $$BCHKP3 
$$BCHK3G 
$$BCIS0A 
$$BCLOSE 
$$BCLOSP 
$$BCL0S2 
$$BCL0S3 
$$BCL0S4 
$$BCLRPS 
$$BCMT01 
$$BCMT02 
$$BCMT03 
$$BCMT0U 
$$BCMT05 
$$BCMT06 
$$BCMT07 
$$BCMT08 
$$BDMPBC 
$$BDMPDC 
$$BDMPPD 
$$BDMPPT 
$$BDMPVA 
$$BDUMP 
$$BDUMPB 

$$BDUMPD 

$$BENDFF 

$$BENDFL 

fi$BENDQB 

^BEOJ 

$$BEOJl 

$$BEOJ2 

$$BEOJ2A 

$$BEOJ3 

$$BEOJ3A 

$$BEOJ4 

$$BE0J5 



Supervisor, 
Supervisor, 



Supervisor, 
Supervisor, 
Supervisor, 
Supervisor, 



program teririnator 

program terminator 
Supervisor, initiator 
Supervisor, nonresident attention routine 
Supervisor, nonresident attention routine 
Supervisor, nonresident attention routine 
Supervisor, nonresident attention routine 

nonresident attention routine 

nonresident attention routine 

nonresident attention routine 

nonresident attention routine 
Process ALTER statement 
Process DSPLY statement 
DUMP command processor 
DUMP command processor 
DUMP command print routine 
Supervisor, nonresident attention routine 
Supervisor, nonresident attention routine 
Display and change dispatcning priority 
SDAIC termination routine 

Storage dump of part of storage specified by two addresses 
LFCB Command processor 1 
LUCB Command processor 1 
LUCB Command processor 2 
UCB Load execution 
System required tape open 
Monitor-EOV/EOF 
Disk- checkpoint 
Disk-checkpoint 
Disk- checkpoint 

Disk-checkpoint, 3800 record processing 
Tape-checkpoint 
Tape- checkpoint 

Tape-checkpoint, 3800 record processing 
Erase gap for logical files 
ISAM - CLOSE 
Close monitor 
Punch file close 
Close 

Close monitor 
Close monitor 
Close RPS 

Tape EOF/EOV input-forward 
Tape CLOSE-alternate switching 
Tape CLOSE input-backward 
Tape EOV output- forward 
Tape CLOSE 

Tape CLOSE - work files 
Tape-alternate switching 
Tape CLOSE - without work files 

Supervisor, program termination and system dump on tape/printer (part 2) 
Supervisor, program terminator, and system dump on disk (part 2) 
Format supervisor block, disk output 
Format supervisor block, tape/printer cutput 
Supervisor, program terminator, and SVA dump 
Supervisor, program teririnator # and system dump monitor 
Supervisor, program terminator, and system dump on tape/printer 
(part 1> 

Supervisor, program terminator, and system dump on disk (part 1) 
ISAM - ENDFL (Load phase 2) 
ISAM - ENDFL (Load phase 1) 

Blocks B-transient area for ENQB/DEQB function 
Supervisor, program terminator 
Supervisor, program terminator 
Supervisor, program terminator 
Supervisor, program terminator 
Supervisor, program terminator 
Supervisor, program terminator 
Supervisor, program terminator 
Supervisor, program terminator 
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$$BEOJ7 

$$BERRTN 

$$BFCB 

SSBFCBOO 

$$BFCB3 

$$BFCB5 

$$BILSVC 

$$BINDEX 

$$BJCOPT 

$$BJC0P1 

$$BJDUMP 

$$BLVTOC 

$$BLSTIO 

$$BMSGWR 

$$BMSGW1 

$$BMVKEY 

$$B0CPM1 

$$BOCPM2 

$$BOCPRP 

$$B0CPT1 

$$B0CPT2 

$$B0CPT3 

$$BOCPTM 

$$BOCP01 

$$BOCP02 

$$BOCP0 3 

$$B0CP11 

$$B0CP12 

$$BOCRTA 

$$BOCRTB 

$$BOCRTC 

$$BOCRTD 

$$BOCRTE 

$$BOCRTF 

$$BOCRTG 

$$BOCRTH 

$$BOCRTK 

$$BOCRTL 

$$BOCRTM 

$$BOCRTN 

$$BOCRTO 

$$BOCRTP 

$$BOCRTQ 

$$BOCRTR 

$$BOCRTS 

$$BOCRTT 

$$BOCRTU 

$$BOCRTV 

$$BOCRTW 

$$BOCRTX 

$$BOCRTY 

$$BOCRTZ 

$$BOCRTl 

$$B0CRT2 

$$BOCRT3 

$$BOCRTU 

$$B0CRT5 

$$B0CRT6 



Supervisor, prograir- teririnator 

System required error recovery 

3211 FCB standard load 

3203-4 FCB standard load 

3203 FCB standard load 

5203 FCB standard load 

Supervisor, program teririnator 

Cylinder index in core (ISAM) 

Job Control, OPEN Tape routine 

Job Control, OPEN Tape routine 

JDUMP indicator 

List VTOC (2311, 2314/1*. 3330, and 3340) 

System control 

Tape open/close 

Tape open/close 

Printlog utility status modifier 

System required message writer 

System required message writer 

System required OPEN for RPS DASD 

System required OPEN for input tape (Phase 1) 

System required OPEN for unlabeled output tape 

System required OPEN for labeled cutput tape 

System required OPEN for input tape (Phase 2) 

System required table, disk DTFs, OPEN Version II 

System required table., nondisk DTFs, OPEN Version II 

System required table, unit record, OPEN Version II 

System required table, tape or disk system DTFs, OPEN Version I 

System required table, tape system DTFs 

CRT task initialization, activation, and deactivation 

Hard- copy disk ERP 

Message analysis and message transfer to screen buffer 

Multiline message transfer to screen buffer 

CRT ERP, part 1 

CRT ERP, part 2 

Redefine message status; output from buffer to screen 

Message writer screen to hard-copy file 

CRT task activator and operator input check routine 

Message deletion by means of K command 

Message deletion by means of cursor 

K-command handler status definition 

Screen line-number handler 

Restore function for release 

Screen update 

Initialize read 

Read/comma nd 

Move data 

Updating of wraparound pointer in hard-copy file 

Cursor positioning in case of error 

Message writer 

Conversation handler 

Multiline message handler 

CRT root phase 

Redisplay - supervisor interface 

Redisplay - command analysis 

Redisplay - read messages from hard-copy file 

Redisplay - write to screen 

Redisplay - save/restore screen image 

Redisplay - command checking 



No te : The DOC-support transients ($$BOCRTn) are automatically 
generated if MODEL=115 or 125 is specified in the CONFG macro. If DOC 
support is not desired, a DELET statement is required for each trans- 
ient. If DOC support is required but one or more of the DOC-support 
transients have been deleted, the systeir enters a hard wait state. 



$$EODACL 
S&BODAIM 
$$BODAIN 
$$B0DAI1 



Close Routine- DA 
Overlay phase for ODAIN 
Direct access input-OPEN (Input) 
Open input-DA 
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$$B0DA01 Direct access-OPEN output Phase 1 

$$B0DAO2 Direct access-OPEN output Phase 2 

$$BODA03 Direct access OPEN-output Phase 3 

$$B0DA04 Direct access OPEN-output Phase 4 

$$BODARP Direct access-OPEN PPS Phase 1 

$$BODARS Direct access-OPEN RPS Phase 2 

$$BODAUl Direct access-OPEN 

$$B0DI01 Diskette OPEN-input Phase 1 

$$B0DI02 Diskette OPEN-output Phase 3 

$$B0DI03 Diskette OPEN-output Phase 4 

$$BODI04 Diskette CLCSE-input/output 

$$B0DIO5 Diskette OPEN-input Phase 3 

$$BODI06 Diskette OPEN-input Phase 4 

$$B0DI07 Diskette OPEN-output Phase 5 

$$B0DI08 Diskette OPEN-output Phase 6 

$$BODMSG Diskette Message Writer Phase 1 

$$BODMS2 Diskette Message Writer Phase 2 

$$BODQUE Dequeue JIBs 

$$BODSMO Diskette security message writer 

$$BODSMW Message writer 

$$BODSPQ Diskette VTOC Display Phase 2 

$$BODSPV Disk VTOC display routine 

$$BODSPW Disk VTOC display routine 

$$BODUCP Diskette DTFCP/DTFDI OPEN 

$$BOFLPT DASD file protect 

$$BOISRP ISAM - OPEN RPS phase 

$$BOIS01 ISAM - OPEN I/O Phase 1 

$$BOIS02 ISAM - OPEN I/O Phase 2 

$$BOIS03 ISAM - OPEN I/O Phase 3 

$$BOIS04 ISAM - OPEN I/O Phase 4 

$$BOIS05 ISAM - OPEN I/O Phase 5 

$$BOIS06 ISAM - OPEN I/O Phase 6 

$$BOIS07 ISAM - OPEN I/O Phase 7 

$$BOIS08 ISAM - OPEN I/O Phase 8 

$$BOIS09 Indexed sequential independent overflow area integrity 

$$BOIS10 ISFMS - OPEN 

$$B0IS11 ISAM - OPEN 

$$BOMRCE OPEN for OMR and RCE 

$$BOMSGl Message writer - non-abort types 

$$B0MSG2 Message writer - abort types 

$$BOMSG3-$$BOMSG8 Message writer 

$$BOMT0M Tape OPEN message 

$$BOMT0W Tape OPEN message 

$$BOMT01 Tape OPEN input-forward- standard labels (Phase 1) 

$$BOMT02 Tape OPEN input-backward-standard labels 

$$BOMT03 Tape OPEN output forward- standard label 

$$BOMT04 Tape OPEN output-standard labels 

$$BOMT05 Tape OPEN I/O-f orward/backward nonstandard/unlabeled 

$$BOMT06 Tape OPEN work files 

$$BOMT07 Tape OPEN input-forward-standard labels (Phase 2) 

$$BONVOL Tape rewriting 

$$BOPEN RMSR tape processor 

$$BOPENC OPENC 

$$BOPEND Disk OPEN volume ID handler 

$$BOPENR Relocation Phase 1 

$$BOPENS Common RPS OPEN initialization routine 

$$BOPEN0 33 40 DTF device type update phase 

$$BOPENl Open monitor 

$$BOPEN2 Open monitor 

$$BOPEN3 Open monitor 

$$BOPEN4 Open monitor 

$$BOPIGN Open monitor 

$$BOPNLB Locates system source statement library (for assembler, COBOL, MAINT, 

and SSERV) or procedure library (for PSERV) 

$$BOPNR2 Relocation Phase 2 

$$BOPNR3 Relocation Phase 3 

| $$BOPR3 Open processing for 3800 printer 

$$BORTVl ISAM Open 

S6BORTV2 ISAM Open 

g$BOSDB1 Support for DLBL blocks I ze 
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$$B0SDC1 

$$B0SDC2 

$$B0SDC3 

$$BOSDEV 

$$B0SDI1 

$$B0SDI2 

$$B0SDI3 

$$BOSDH» 

$$B0SDI5 

$$B0SD01 

$$BOSD02 

$$B0SDO3 

$$B0SD0<4 

$$B0SD05 

$$B0SD06 

$$B0SD07 

$$BOSD08 

$$B0SD09 

$$BOSDRP 

$$BOSDRR 

$$BOSDRS 

$$B0SDW1 

$$B0SDW2 

$$B0SDW3 

$$BOSD00 

$$BOSD01 

$$BOSD02 

$$BOSD03 

$$BOSIGN 

$$BOUR01 

$$BOVDMP 

$$BOWDMP 

$$B02321 

$$BPCHK 

$$BPCLOS 

$$BPDAID 

$$BPDUMP 

$$BPDMPC 

$$BPSW 

$$BRELSE 

$$BRMSG1 

$$BRMSG2 

$$BRSTRB 

$$BRSTRT 

$$BRSTR2 

$$BRSTR3 

$$BRSTRU 

$$BSDRUP 

$$BSETFF 

$$BSETFG 

$$BSETFH 

$$BSETFI 

$$BSETFL 

$$BSETL 

$$BSETL1 

$$BSETL2 

$$BSYSWR 

$$BTERM 

$$BUCB 

SSBUCBOO 

$$BUCB3 

$$BUCB5 

$$BUFLDR 

$$BUFLD1 

$$BUFLD2 

$$BVSDMP 

$$B3540I 

$$B35U0O 

$$B35U00 

$$BPDZAP 

$$VOPENT 



Sequential disk I/O - CLOSE 

Sequential disk-close 

Sequential disk-close Part 2 

DTFDA and DTFSD Forced End of Volume 

Sequential disk input - OPEN 

Sequential disk input - OPEN 

Sequential disk input - OPEN 

Sequential disk input - OPEN 

Sequential disk OPEN - update phase 

Sequential disk output Phase 1 - OPEN 

Sequential disk output Phase 2 - OPEN 

Sequential disk output Phase 3 - OPEN 

Sequential disk output Phase *i - OPEN 

Sequential disk output Phase 5 - OPEN 

Sequential disk open - Phase 6 

Sequential disk output - OPEN 

Sequential disk output - OPEN 

Sequential disk output - OPEN 

Sequential disk OPEN-RPS Phase 1 

Sequential disk OPEN-RPS Phase 2 

Sequential disk OPEN-RPS Phase 3 

Sequential disk work files Phase 1 - OPEN 

Sequential disk work files Phase 2 - OPEN 

Sequential work file Phase 3 - OPEN 

Sequential disk OPEN - output Phase 

Sequential disk OPEN - output Phase 1 

Sequential disk OPEN - DLBL extents for 33 UO 

Sequential disk OPEN - Output Phase 1 

System open 

Unit record-OPEN routine 

Disk VTOC dump 

Disk VTOC dump 

OPEN data cell 

Supervisor - program terminator 

Automatic Close for 3800 printer 

Problem Determination 

PDUMP on SYSLST (part 1) 

PDUMP on SYSLST (part 2) 

Supervisor - program terminator 

Device release 

Message writer CHKPT-RSTRT 

CHECKPOINT-RESTART message writer 

Tape Restart 

RESTART message writer - Phase 2 

Tape and DASD verify for restart 

DASD verify for restart 

Tape Reposition 

Suppress writing on recorder file 

ISAM load Phase 2 of SETFL 

ISAM load Phase 3 of SETFL 

ISAM load Phase «* of SETFL 

ISAM Phase of SETFL 

ISAM load Phase 1 of SETFL 

ISMOD - SETL 

ISMOD - SETL 

ISMOD - SETL 

Supervisor, nonresident attention 

Supervisor, program terminator 

3211 UCSB standard load 

3203-4 UCSB standard load 

3203 UCSB standard load 

5203 UCSB standard load 

3203, PRT1, 5203, and 3800 FCB and UCSB IPL loader 

3203, PRT1, 5203, and 3800 FCB IPL loader 

FCB and UCSB IPL loader error routine 

Highspeed dump 

Diskette OPEN- input Phase 1 

Diskette OPEN- output Phase 1 

Diskette OPEN- Phase 

I/O for PDZAP 

Common RPS OPEN SVA loading routine 
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Attention Routines, Initiators, Terminators, 
and Dumps (AIT) 



RELOCATABLE LIBRARY 



Modules 



Standard System Dump 



C ORE IMAGE LIERARY 

Transients 

$$BDMPBC 

$$BDMPDC 

$$BDMPPD 

$$BDMPPT 

$$BDMPVA 

$$BDUMP 

$$BDUMPB 

$$BDUMPD 

$$BJDUMP 

$$BPDMPC 

$$BPDUMP 



R ELOCATABLE LIBRARY 
Modules 

IJBDMB * 
IJBDMBST 
IJBDMD * 
IJBDMDST 
IJBDMPMO * 
IJBDMPPD * 
IJBDMPPT * 
IJBDMPVA * 
IJBDUMPS 
IJBJDMP * 
IJBPDPMO * 
IJBPDPST 

♦ Modules comrron to Standard System Dump and 
Translating System Bump. 

Link-Edit Statements 

INCLUDE IJEDUMPS 
// EXEC LNKEDT 



Translating System Dump 



CORE IMAGE LIERARY 

Transients 

$$BDMPBC 
$$BDMPDC 
$$BDMPPD 
$$BDMPPT 
$$BDMPVA 
$$BDUMP 
$$BDUMPB 
$$BDUMPD 
$$BJDUMP 
$$BPDMPC 
| SSBPDUMP 



IJBDMB * 
IJBEMBTR 
IJBDMD * 
IJBDMDTR 
IJBEMPMQ * 
IJBDMPPD * 
IJBDMPPT * 
IJBEMPVA * 
IJBDUMPT 
IJBJDMP * 
IJBPDPMO * 
IJBPBPTR 

♦Modules common to Standard System Dump and 
Translating System Dump. 

Link-Edit St atements 

INCLUDE IJBDUMPT 
// EXEC LNKEDT 



Attention Routines, Initiators, 
Terminators 

CORE IMAGE LIBRARY 

Transi ents 

$$AEERRZ 

$$ABERZ1 

$$A£ERZ2 

$$BATTNA 

$$EATTNE 

$$BATTNC 

$$BATTND 

$$BATTNE 

$$BATTNF 

$$BATTNG 

$$BATTNH 

$$BATTNQ 

$$BATTNR 

$$BATTNS 

$$BATTNY 

$$BATTNZ 

$$BATTN2 

$$BATTN3 

$$BEOJ 

$$BEOJSl 

$$BEOJS2 

$$BEOJl 

$$BEOJ2 

$$BEOJ2A 

$$BEOJ3 

$$BE0J3A 

$$BEOJ4 

$$BE0J5 

$$BEOJ7 

$$BILSVC 

$$EPCHK 

$$BPSW 

$$BSYSWR 

$$BTERM 
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Checkpoint/Restart 



CORE IMAGE LIBRARY 

Transients 

$$ECHKPD 
$$BCHKPE 
$$BCHKPF 
$$BCHKPT 
$$BCHKP2 
$$BCHK3G 
$$BRMSG1 
$$BRMSG2 
$$BRSTRT 
$$BRSTR2 
$$BRSTR3 
$$BRSTR4 



SOURCE STATEMENT LIBRARY 



Macro 



$$BOCRTH 
$$BOCRTK 
$$EOCRTL 
$$BOCRTM 
$$BOCRTN 
$$EOCRTO 
$$BOCRTP 
$$EOCRTQ 
$$BOCRTR 
$$EOCRTS 
$$BOCRTT 
$$EOCRTU 
$$BOCRTV 
$$BOCRTW 
$$BOCRTX 
$$BOCRTY 
$$BOCRTZ 
$$B0CRT1 
$$B0CRT2 
$$B0CRT3 
$$BOCRT*» 
$$B0CRT5 
$$B0CRT6 



CHKPT 

If RPS is supported see section "RPS 
Considerations" . 



Disk Error Recovery Procedures (DKE) 



CORE IMAGE LIERARY 



SOURCE S TA T EMENT LIBRARY 
Macros 

CRTAEX 

CRTAWT 

CRTGEN 

CRTIO 

CRTSAV 

PUTR 



Transients 

$$ABERRB 
$$ABERR1 
$$ABERR2 
$$AEERR3 
$$ABERR4 
$$ABERR5 



SOURCE STATEMENT LIBRARY 



Macro 



SGDSK 



Display Operator Console Support (DOC) 



CORE IMAGE LIBRARY 

Transients 

$$BMVKEY 
$$BOCRTA 
$,$BOCRTB 
$$BOCRTC 
$$BOCRTD 
$$BOCRTE 
$$BOCRTF 
$$BOCRTG 



PRINTLOG (Print the Hard-Copy 
File) 

CORE IMAGE LIBRARY 













r 

j Phases 
| Blocks 
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Phase 










PRINTLOG 










RELOCATABLE 


LIBRARY 
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(Modules 
| Blocks 
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Module 










IJBPRT 










Link-Edit 


Statements 







INCLUDE IJBPRT 
// EXEC LNKEDT 
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Tape Error Recovery Procedures (TPE) 



CORE IMAGE LIBRARY 



Transients 



$$ABERAB 
$$ABERAC 
$$ABERAD 
$$AEERAE 
$$ABERAF 
$$ABERAG 
$$ABERAH 
$$ABERAI 
$$RAST07 
$$RAST12 

Phase 

ESTVUT 



RELOCATABLE LIBRARY 

Module 

IJBTESUT 

Link-E dit St atements 

INCLUDE IJBTESUT 
// EXEC LNKEDT 



$$BATTNV 
$$BATTNfc 
$$BATTNX 
$$BPDAID 



REL OCATABLE LIBRARY 

Modules 

IJBPDAID 
IJBPELST 

Link-Ed it S tatements 

// JOB 

// OPTION CATAL 

INCLUDE IJBPDAID 

// EXEC LNKEDT 

INCLUDE IJBPDLST 

// EXEC LNKEDT 

/& 



DUMPGEN 



CORE IMAGE LIBRARY 



Phase 



DUMPGEN 



Problem Determination Aids (PDA) 



RELOCATABLE LIBRARY 



PDAID 

CORE IMAGE LIBRARY 

Phases 

PDAIDFTT* 
PDAIDFTP* 
PDAIDFTW* 
PDAIDGTT* 
PDAIDGTP* 
PDAIDGTW* 
PDAIDITT* 
PDAIDITP* 
PDAIDITW* 
PDAIDQTT* 
PDAIDQTW* 
PDAIDTDP* 
PDAIDTDT* 
PDAIDVTT* 
PDAIDVTW* 

♦Only present in core-image library. 

Transients 

$$BATTNT 
$$BATTNU 



Module 



IJBEMPGN 



Lin k-Edit St atements 

INCLUDE IJBDMPGN 
/* 
// EXEC LNKEDT 



SDAID 



CORE IMAGE LIBRARY 



Pha ses 

SDAID 
SDAID 2 
SDPAR 
ENDSD 



Transi ents 

$$BSDAID 
$$BATTN5 
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RELOCATABLE LIBRARY 



Link-Edit Statements 



Modules 



IJBSDAD1 
IJBSDAD2 
IJBSDEND 
IJBSDPAR 



Link-Edit Statements 



// JOB 

// OPTION CATAL 

INCLUDE IJESDLNK 
/* 
// EXEC LNKEDT 



// JOB 

// OPTION CATAL 

INCLUDE IJBPDZAP 
/* 

// EXEC LNKEDT 
/6 



Highspeed Standalone Dump 

CORE IMAGE LIBRARY 

Pha se 

DOSVSDMP 

Transient 

$$BVSDMP 



LSERV 

CORE IMAGE LIERARY 

Phase 

LSERV 

RELOCATABLE LIBRARY 

Module 

IJBLSERV 

Link-Edit Statements 

INCLUDE IJBLSERV 
/* 
// EXEC LNKEDT 

CBL Patch Program (PDZAP) 



KELOCATABLE LIBRARY 

Modules 

IJBDMPER 
IJBDMPHS 
IJBDMPMS 

Link-Edit St atements 

// JOB 

// OPTION CATAL 

INCLUDE IJEDMPHS 
// EXEC LNKEDT 
/& 

Page Data Set Dump 

CORE IMAGE LIBRARY 

Phase 

PESEM 



CORE IMAGE LIERARY 

Phas e 

PDZAP 

Transient 

$$BPDZAP 

RELOCATABLE LIBR ARY 
Module 



IJBPDZAP 



RELOCA TABLE LIBRARY 

Module 

IJEPDSDM 

Link-E d it Statements 

INCLUDE IJEPDSDM 
/* 

// LELTYP TAPE (see Note) 
// EXEC LNKEDT 

Note : Required only if tape is to be used 
for intermediate storage of the page data 
set dump. 
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Module 2: POWER/ VS - 5745-SC-PWR 



I The information previously provided in this module of the manual has been removed and is 
| now contained in DOS/VS PQKER/VS Installation Guide and Reference, GC33-6048. 
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Module 3: Installation Verification Procedure 



Module Outline 

introduction 137 

the standard SCP functions 137 

the optional SCP functions 137 

IVP books 137 

IVPGEN-stage I — assembly 137 

IVPGEN-stage II — execution 138 

preparing the IVP job stream 142 

setup requirements 1 42 

operating instructions 142 

ABD - the ABEND dump 143 

ASL 143 

example of SYSLOG output 143 

example of SYSLST output 143 

CAP - cataloged procedures 147 

setup requirements 147 

example of SYSLOG output 147 

example of SYSLST output 148 

EMA - 1401/1440/1460 emulator 157 

functions tested 157 

IVPGEN macro options 157 

required parameters 157 

optional parameters 157 

software requirements 158 

emulator macro options 158 

hardware requirements 159 

storage requirements 159 

operating instructions 159 

EMB - 1410/7010 emulator 159 

functions tested 159 

IVPGEN macro options 159 

required parameter 159 

optional parameters 1 59 

software requirements 160 

hardware requirements 1 60 

storage requirements 161 

operating instructions 161 

E20 - System/360 model 20 emulator 

functions tested 161 

IVPGEN macro options 161 

required parameter 161 

hardware requirements 162 

operating instructions 1 62 

example of SYSLOG output 163 

example of SYSLST output 164 

OLT - OLTEP 165 

function tested 165 

operating instructions 165 

action messages 165 

PWR - POWER/VS 16 5 

function tested 165 

software requirements 165 

UTL - system utilities 165 

functions tested 165 

hardware requirements 166 



Module 3: Installation Verification Procedure 135 



Module Isidex 



ABD 138, 143 
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ASL - 138,143 
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ESERV program (ASL) 143 
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IVPGEN 
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Introduction 



DOS/VS provides Installation Verification Procedures to enable you to verify the 
generation of system components. IVP verifies components such as the emulators, which 
are user-assembled, and system utilities. 

The IVP consists of a set of macros (containing the verification procedures) which are 
distributed, along with tne DOS/VS system, on the IBM-supplied distribution iredium. 
Towards the end of system generation, after having deleted any unwanted DOS/VS system 
components and having generated the components you require for verification, you should 
perform the installation verification procedure. 

The verification procedures are generated by assembling the IVPGEN macro. A number of 
parameters specify the optional SCP functions selected for verification, in addition to 
the standard functions which are included automatically. The standard functions are not 
included if you are running the program again to verify one or more functions only 
(indicated by the parameter RERUN=YES in the IVPGEN macro). For a complete description 
of the parameters of the IVPGEN macro refer to the section entitled "IVPGEN Parameters". 

The standard SCP Functions 

ABD - The AEEND Dump (part of program 57 4 5-SC-AIT) 

ASL - The assembler librarian Edit/De-Edit routines (part of the assembler program 

5745-SC-ASM) 
UTL - The system utilities Disk-Only functions. Card, tape, and data cell functions are 

configuration dependent and optional (part of program 574 5-SC-UTL) . 

The Optional SCP Func tions 

CAP - Cataloged procedures 

EMA - System/370 Emulator for IBM 140 1/1440/1460) Available only as 

EMB - System/370 Emulator for IBM 1410/7010 f independent release 

E20 - System/360 Model 20 Emulator 

OLT - OLTEP 

PWR -• POWER/VS 

IVP Books 

The separate parts that make up each verification procedure are contained in one or irore 
pre-edited source statement library macro books. 

IVPGEN-Stage I — Assembly 

IVPGEN is a two-stage process. In stage I„ the IVPGEN rracro calls in the control books 
of the standard and selected SCP functions. The generated job stream (input for stage 
II) is SYSPCH output. You may assign SYSPCH to a card punch, a magnetic tape unit, a disk 
extent, or a diskette. If, however, parameters UTL=YES and PCHADDR are both specified, 
you may assign SYSPCH to a card punch only. For cardless systems, do not specify PCHADDK 
if you specify 0TL=YES. 

If SYSPCH is assigned to a card punch, you must remove the punched deck (output of 
stage I) from the stacker and put it in a card reader as input to stage II (IVP 
execution).. The last card (an object END card) of the deck must be reiroved. 

If SYSPCH is assigned to either tape,, disk, or diskette there is an automatic 
transition from stage I to stage II provided that the required job control statements are 
punched (see Figure 3-1) . 

At the very beginning of system generation, you can assemble the IVPGEN macro with the 
option VERIFY=YES, under control of the IBM-supplied supervisor. This will provide you 
with a diagnostic of the specified parameters. It also provides you (if specified in the 
IVPGEN assembly) with a job stream to delete the unused IVP books. 

This job can be run to free up space in the source statement library. The advantage 
of specifying VERIFY=YES is that you have ample time to correct any specification errors 
before the IVP procedure is actually performed at the end of system generation,. 
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IVPGEN-Stage II — Execution 

Before it actually starts executing the verification, stage II successively performs 

• LISTIO ALL to display (on SYSLST) all the devices that are supported 

• MAP to display (on SYSLOG) the sizes of the partitions assigned 

• DSERV of all the assigned libraries to display in alphabetical order (on SYSLST) the 
names of all the transients, phases, modules, macros, and (optionally) procedures, 
that the system comprises. 

IVPGEN Parameters 

A. Component Dependent 



ABD=fYES) 
\ NO/ 



The ABEND dump IVP is always automatically generated (YES is 
forced) unless R£RUN=YES is specified in which case ABD=NO is 
the default 



ASL=f YES ) 
I NO/ 



The display, verify, replace,, and delete capabilities of the 
ESERV program are automatically verified (YES is forced) unless 
RERUN=YES is specified, in which case the default for ASL is NO. 



CAF=f NO) 

\yesj 



Specify if Cataloged Procedures Support is to be verified. 



EMA= 



\YESf 



Specify if the DOS/VS 1401/1440/1460 Emulator program is to be 
verified. 



EMANAME=name 



Specify the phase name of the user-generated 1401/1440/1460 
emulator program. 



EMATA=cuu 



Device address of the tape unit assigned to 1400 tape unit 1, 
Specify only if tape functions are to be verified. 



EMATSN=SYSnnn 



Name of the logical unit assigned to 1400 tape unit 1. Specify 
only if tape functions are to be verified. 



EMATYPE= 



(1401 ) 
<1401G> 
(1440 ) 



Specify the type of verification procedure to be selected. 
Refer to the section entitled "EMA-1401/1440/1460 Emulator" for 
a detailed description of the EMATYPE operands. 



EMACCS= 



(YES/ 



Specify if CS control cards support is required in the 
user-generated 1401/1440/1460 emulator program (CTLCARD=CS in 
the emulator EMSUP macro instruction) . 



EME=f NO) 



YES J 



Specify if the DOS/VS 1410/7010 Emulator program is to be 
verified. 



-H 



EMENAME=name 



Specify the phase name of the user-generated 1410/7010 emulator 
program. 



EMETA=cuu 



Device address of the tape unit assigned to 1400 tape unit 1, 
channel 1. Specify only if tape functions are to be verified. 



EMBTSN=SYSnnn 



Name of the logical unit assigned to 1400 tape unit 1, channel 
1. Specify only if tape functions are to be verified. 



— I 



£20=^ NO) 
iYESf 



Specify if the System/360 Model 20 Emulator program generation 
is to be verified. 



E20NAME=name 



Specify the phase name of the user-generated System/360 Model 20 
Emulator program. 



OLT=( NO ) 

\yes; 



Specify if the IVP job for OLTEP is to be generated. 
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A. Component Dependent (continue d) 



PWP= 



( NO) 

\YEsf 



+ . 

\ NO/ J i 



Specify if the IVP job for POWER/VS is to be generated. 



UTL= 



The disk functions of the system utilities are automatically 
verified (YES is forced) unless RERUN=YES is specified in which 
case the default for UTL is NO. 



UTLDA=(cuu,cuu) 



Specify the disk device addresses of two work disks for use by 
the disk functions of the system utilities. 



UTLDRT=nnnn 



Disk extent relative track number of a one-track work space on 
the disk work volumes. 



UTLDT= f 3330) 
\nnnnj 



Specify the device type of the two work disks. 



UTLDV= (nnnnnn, mmmmmnO 



Specify the volume serial numbers of the two work disks in the 
same order as specified by the UTLDA parameter. 



UTLT= 



\YESf 



Specify if the tape functions of the system utilities are to be 
verified. 



UTLTA=cuu 



Specify the device address of the tape drive on which a work 
tape is to be mounted. 



UTLTM= f CO 



pi 

(mmf 



Specify the tape device mode. If this parameter is omitted, 
a 9-track, 1,600 BPI tape is assumed. 



UTLZ= 



i -4 

IYESJ 



Specify if the data cell functions of the system utilities are 
to be verified. 



UTLZA=cuu 



Specify the device address of the data cell drive that contains 
a work cell to be used by the Installation Verification Program, 



-+ 



UTLZCN=n 



Specify the number of the work data cell. 



UTLZRT=nnnn 



Specify the data cell extent relative track number of a 
one-track work space on the data cell work volume. 
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R. Component Independent 



DELUNSD=IYES) 
X NO/ 



Specify if a delete job is to be generated for those IVP books 
that are not used in this assembly of the IVPGEN iracro. 



DELUSED=< NO) 
jYESj 



Specify if a delete job is to be generated for all tne IVP books 
that are used in this assembly of the IVPGEN macro. 



IPTADDF= 



fooc) 

(cuuf 



Device address of the system input device. SYSRDR and SYSIPT 
will be reset to this address after completion of IVP stage II. 



LSTADDR= 



(00E) 
(cuuf 



Device address of the system printer during the execution of 
IVP stage II. 



PCHAEDR=cuU 



Device address of the sys 
IVP stage II. If no veri 
the system utilities is d 
specified. For cardless 



tern card punch during the execution of 
ficaticn of disk-to- card functions of 
esired, this parameter should not be 
systems, PCHADDR must be omitted. 



RERUN=( NO) 
tYESj 



Specify YES if this IVP i 
if one or more SCP functi 
RERUN=YES is specified, a 
and UTL.. 



s a rerun. A rerun can be performed 
ons are to be verified again. If 
default of NO is taken for ABD, ASL, 



VERIFY=( N0\ 
(YES! 



Specification of YES caus 
generation of an IVP stag 
only job that is generate 
books (if DELUNSD=YES) . 



es a diagnostic to be made without 
e II job stream. In this case, the 
d is the delete job for the unused IVP 
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r 

IVP STAGE I INPUT — CREATION OF IVP STAGE II JOBSTREAM 



In cards 

// JOB IVPSTG1 

LOG 
// OPTION DECK 
// EXEC ASSEMBLY 

IVPGEN selected parameters 

END 
/* 
/& 



On tape 

// JOB IVPSTG1 

LOG 
// PAUSE "OPERATOR PLEASE MOUNT A SCRATCH TAPE ON UNIT X'cuu*" 

MTC REW, X'CUU" 
ASSGN SYSPCH, X'cuu' Assign SYSPCH to tape 
// OPTION DECK 
// EXEC ASSEMBLY 

IVPGEN selected parameters 

END 
/* 

CLOSE SYSPCH, X" 00D' Close SYSPCH and reset to standard assignment 
// PAUSE OPERATOR PLEASE MOUNT TAPE ON UNIT X'cuu' AGAIN 
ASSGN SYSIN, X'cuu' Set to address of tape unit 
/& 



On disk or diskette 

// JOB IVPSTG1 

LOG 
// DLBL IJSYSPH,, ' IVP STAGE II JOBSTREAM' Stage 1 output 
// EXTENT SYSPCH, nnnnnn,, „ ,nnnn,nnnn (see Note) 

// DLBL IJSYSIN,*IVP STAGE II JOBSTREAM' Stage 2 input 
// EXTENT SYSIN„nnnnnn, , ,nnnn,nnnn (see Note) 

ASSGN SYSPCH , X'cuu' Assign SYSPCH to disk 
// OPTION DECK 
// EXEC ASSEMBLY 

IVPGEN selected parameters 

END 
/* 

CLOSE SYSPCH, X'OOD' Close SYSPCH and reset to standard assignment 
ASSGN SYSIN, X'cuu' Set to disk address 

Note : The extent information and volume sequence numbers in the two EXTENT statements 
must be identical. 

Figure 3-1. Example of IVP Stage I Job Control Statements 
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PREPARING THE IVP JOB STREAM 



I 



Setup Requirements 

SYS001, SYS002, SYS003, and SYSLNK must be assigned to disk work extents. 

If SYSPCH is assigned to a disk device, the allocated extent must be at least 4 cylinders 
on a 2316 disk pack, 3 cylinders on a 3336 disk pack, 7 cylinders on a 3348 data module, 
or 2 cylinders on the disk pack of a 3350 direct access storage. 

A minimum of 14K bytes of real storage must be allocated to the partition in which the 
IVP jobs are to be executed. If POWER/VS functions are to be verified at the same time, 
add the storage requirements for POWER/VS to the allocated real and virtual storage. 
These reguirements are given in DOS/VS POWER/VS Installation Guide and Reference 
GC3 3-6048. 

Operating Instructions 

Prepare the following job control statements: 

Step 1 

// JOB ASSEMBLE IVPGEN 

// ASSGN SYSPCH,, X'cuu' (can be card, tape, disk, or diskette) 

// ASSGN SYS001, X'cuu* work file 

// ASSGN SYS002, X'cuu' work file 

// ASSGN SYS003, X'cuu" work file 

// EXEC ASSEMBLY 

IVPGEN (selected parameters) 

END 
/* 
/£ 

Step 2 

If SYSPCH is assigned to a card punch, remove the last card from the deck. This is the 
(object) END statement, which cannot be processed by Job Control. Put the remaining 
cards in the hopper of the reader, assigned to SYSIN. Press START and EOF. IVP stage II 
will now be executed. 

Step 3 

If SYSPCH is assigned to tape, disk., or diskette, close SYSPCH (if SYSPCH was assigned to 
tape, ready the tape device again) and assign SYSIN to the same tape, disk or diskette 
device. This will start the execution of IVP stage II. 

Stage II successively executes a: 

LISTIO ALL to display (on SYSLST) all the devices supported. 
MAP to display (on SYSLOG) the partition sizes assigned. 

DSERV DSPLYS ALL to provide a sorted printout of the library directories. 

Furthermore,, stage II performs the standard IVP functions that is verification of the 
ABEND dump,, of the Assembler and Utility Programs, and of all optional functions 
selected. It also produces the delete jobs for used and/or unused IVP books (if 
specified) . 
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ABD - The ABEND Dump 

The ABD function forces an abnormal end-of-job condition. A real storage duirp is printed 
on SYSLST, 

ASL 

This IVP function verifies the display and update capabilities of the ESERV program. 
Example of SYSLOG Output 

BG // JOB IVPASL TEST ESERV 

DATE 11/04/73, CLOCK 07/22/56 

QQ * ********************************************************************* 

BG * IDENTIFICATION : ESERV PROGRAM 

BG * PURPOSE : TO SHOW THE DISPLAY AND UPDATE CAPABILITYS OF ESERV 

BG * FUNCTIONS TESTED : DISPLAY, VERIFY, REPLACE, DELETE 

BG * SET UP REQUIREMENTS : SYS002 MUST BE ASSIGNED 

BG * TO DISK, SYSLST MUST BE ASSIGNED 

BG * NORMAL COMPLETION MESSAGES : * IVPASL COMPLETED ++ +++++++++++++ 

BG * LISTING CONTAINS INSTRUCTIONS ON HOW TO 

BG * CHECK FOR SUCCESSFUL EXECUTION 

BG * MODULES TESTED/ USED : IPKAD, IPKVA, IPKVD, IPKVE, IPKVF, 

BG * IPKVG, IPKVI, IPKVK, IPKVM 

BG * INPUT DESCRIPTION : TWO DSPLY CONTROL CARDS, THE SECOND 

BG * FOLLOWED BY ) COL, ) VER, ) REP, ) DEL 

BG * AND ) END CARDS, AN EDITED MACRO 

BG * C IVPASLS ) IN THE E SUBLIBRARY 

BG * OUTPUT DESCRIPTION : A DISPLAY OF IVPASLS, A DISPLAY OF IVPASLS, 

BG * UPDATED BY THE ) REP CARDS, AN UPDATE SURVEY 

BG * ******************************************************************** 

BG * IVPASL COMPLETED ++++++++++++++++++++++++ 

BG EOJ IVPASL 

DATE 11/04/73, CLOCK 07/24/59, DURATION 00/02/02 
BG 1C00A ATTN. 0C. 
BG 



E xample o f SYSLST Output 

// JOB IVPASL TEST FSERV DATE 1 1 /04/ 73 f CLOCK 0"V22/F6 

* ***************************************************************** 

* IDENTIFICATION: FSERV PROGRAM 

* PURPOSE: TO SHOW THE DISPLAY AND UPDATE CAPABILITYS OP ESERV 

* FUNCTIONS TESTED: DISPLAY, VERIFY, REPLACE, DELETE 

* SET UP REQUIREMENTS: .SYS001, SYSOC2 MUST BE ASSIGNED 

* TO DISK, SYSLST MUST BE ASSIGNED 

* NORMAL COMPLETION MESSAGES: * IVPASL COMPLETED +++++++++++♦++++++++ 

* LISTING CONTAINS INSTRUCTIONS ON HOW TO 

* CHECK ^OR SUCCESSFUL EXECUTION 

* MODULES TESTED/USED: I PKAD , I PKVA ,1 PKVD, I PKVE, I PKVP, 

* IPKVG, IPKVI , IPKVK, IPKVM 

* INPUT DESCRIPTION: TWO DSPLY CONTROL CARDS, THE SECOND 

* FOLLOWED BY ) COL, ) VER, ) REP, ) DEL 

* AND ) END CARDS, AN EDITED MACRO 

* (IVPASLS) IN THE E SUBLIBRARY 

* OUTPUT DESCRIPTION: A DISPLAY OP IVPASLS, A DISPLAY OP IVPASLS, 

* UPDATED BY THE ) REP CARDS, AN UPDATE SURVEY 

* ****************************************************************************** 

// EXEC ESERV 
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DSPLY F.IVPASLS 



E. IVPASLS 



75/01/0* 



E.IVPASLS 



CATALS A. IVPASLS 
MACRO 
I VPASL S SPP 1 , £PP2 , 6PP3 , £PP4 , £PP5 , £PP6 , 

£KW1>,£KW2*»£KW3° 
' DISK OPERATING SYSTEM 

' IVPASLS - 5745-SC-ASM - RELEASE 28.0 
' /* START OF SPECIFICATIONS ********************************* 



1 
2 
3 

4 
5 
6 

7 * 

8 *01* MODULE-NAME = IVPASLS 

9 * 

10 *01* DESCRIPTIVE NAME 



11 * 

12 * 

13 * 

14 *0l* FUNCTION « AS FOLLOWS. 



INSTALLATION VERIFICATION PROCEDURE 
TEST PROGRAM FOR ESERV PROGRAM 
-SOURCE BOOK- 



15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 

26 * 

27 *01* NOTES = CHANGE ACTIVITY 



THIS MACRO IS USED AS INPUT TO THE ESERV PROGRAM IN THE 
INSTALLATION VERIFICATION PROCEDURE (IVP). TO CHECK THAT 
THE IVP WAS SUCCESSFUL, COMPARE THE TWO DISPLAYS OF THIS 
MACRO THE IVP PRINTS. THEY OUGHT TC RE EQUAL, EXCFPT 
FOR TWO STATEMENTS. THE STATEMENT NUMBER OJ7500 

AIF (T'CPP2 EQ 'OM-THO 
IN THE FIRST DISPLAY WILL BE CHANGED TO - 

AIF (T'£PP2 EQ '0'). THREE 
IN THF SECOND DISPLAY. THE STATEMENT NUMBER 014000 

MNOTE • VALUE OF ££PP5 IS £PP6' 
IN THE FIRST DISPLAY HILL BE DELETED IN THE SECOND OISPLAY 



3 DENOTES CHANGE ACTIVITY FLAGS. D IS SVSTEM IDENTIFIER 

FOR DOS. MEANING OF THE THIRD CHARACTER IS: A = APAR, 

M = PTM, L = NEW DEVELOPMENT. ALL OTHER CHARACTERS ARE 

FOR IBM INTERNAL USE. 



28 
29 
30 
31 

32 * 

33 *01* CHANGE ACTIVITY = AS FOLLOWS. 



34 
35 
36 
37 

38 

39 

40 

41 

42 

43 

44 .ONE 

45 

46 tGBLA 

47 .TWO 
48 

49 CGfiLB 

50 .THREE 
51 

52 CGBLC 



CHANGE DESCRIPTIONS. 

NFW MODULE - FIRST RELEASE 28. 



/* END OF SPECIFICATICNS *********************************** 
GBLA CGBLA 
GRLP &GBLB 
GBLC CGBLC 
LCLA &LCLA 
LCLB CLCLB 
LCLC CLCLC 



ANOP 

AIF 

SETA 

ANOP 

AIF 

SETP 

ANOP 

AIF 

SFTC 



IT'SPPl EQ 

appi 



(T«£PP2 EO 
( I) 



<T'£PP3 EQ 
•£PP3* 



00250000 
00310000 
00310000 
00320000 
00330000 
00340000 
00342000 
00344000 
00346000 
00348000 
00348100 
00348200 
00348600 
00349000 
00349100 
00349200 
00350900 
00352900 
00355000 
00356800 
00357200 
00357600 
00360900 
00361500 
00361900 
00364000 
00366100 
00368200 
00371300 
00372400 
00374500 
.28301 00376600 
00378600 
00380600 



00650000 
00700000 



10750000 
00800000 



00850000 
00900000 



53 .FOUR 
54 

55 £LCLA 

56 .FIVE 
57 

58 £LCLB 

59 .SIX 
60 

61 £LCLC 

62 .SEVEN 
63 

64 

65 .EIGHT 

66 

67 

68 .NINE 

69 

70 

71 

72 .TEN 

73 

74 

75 .ELEVEN 

76 

77 



ANOP 

AIF 

SETA 

ANOP 

AIF 

SETB 

ANOP 

AIF 

SETC 

ANOP 

AIF 

MNOTE 

ANOP 

AIF 

MNOTE 

ANOP 

AIF 

MNOTE 

MNOTE 

ANOP 

AIF 

MNOTE 

ANOP 

MNOTE 

MEND 



(T'fcKWl EQ 'OM-FIVE 
£KW1 

(T'£KW2 EQ 'OM.SIX 
(1) 

(T'£KW3 EQ '0'). SEVEN 
•£KW3' 

(T«£PP4 EQ 'OM. EIGHT 
•VALUE OF ££PP4 IS £PP4 ■ 

IT'£PP5 EQ 'O'l.NINE 

• VALUE OF ££PP5 IS £PP5 ' 

(T'£PP6 EO 'O'J.TEN 

• VALUE OF ££PP5 IS £PP6 ' THIS STATEMENT W 

• VALUE OF ££PP6 IS £PP6' 

(NOT £GBLB AND NOT £LCL8) . ELEVEN 

• VALUE OF C£PP2«££KU2 IS GPP2+SKH2' 

• S&PP2 AND/OR ££KM2 NOT SPECIFIED' 



00950000 
01000000 

01050000 
01100000 

01150000 
01200000 

01250000 
01300000 

01350000 
01360000 

01370000 

ILL BE DELETED 01400000 

01450000 

01500000 
01550000 

01600000 
01750000 



144 DOS/VS System Generation 



DSPLY F.IVPASLS 



E. IVPASLS 



CATALS A. IVPASLS 
MACRO 
I VPASL S SPP 1 1 SPP2 ,£PP3 , EPP4 , SPP5 , GPP6 , 
£KW1=,GKW2=,£KW3= 
< DISK OPERATING SYSTEM 

' IVPASLS - 5745-SC-ASM - RELEASE 28.3 
1 /* START OF SPECIFICATIONS ********************************* 



1 
2 
3 

4 
5 
6 

7 * 

8 *01* MODULE-NAHE = IVPASLS 

9 * 

10 *01* DESCRIPTIVE NAME 



11 * 

12 * 

13 * 

14 *01* FUNCTION = AS FOLLOWS. 



INSTALLATION VERIFICATION PROCEDURE 
TEST PROGRAM FOR ESERV PROGRAM 
-SOURCE BOOK- 



15 ' 

16 < 

17 i 

18 < 

19 * 

20 * 

21 * 

22 < 

23 < 

24 * 

25 * 

26 * 

27 ♦Ol* NOTES 



THIS MACRO IS USED AS INPUT TO THE ESERV PROGRAM IN THE 
INSTALLATION VERIFICATION PROCEDURE (IVP». TO CHECK THAT 
THE IVP WAS SUCCESSFUL, COMPARE THE TWO DISPLAYS OF THIS 
MACRO THE IVP PRINTS. THEY OUGHT TO BE ECUAL, EXCEPT 
FOR TWO STATEMENTS. THE STATEMENT NUMBER 007500 

AIF (T'£PP2 EQ 'O'J.TWO 
IN THE FIRST DISPLAY WILL BE CHANGED TO - 

AIF (T'CPP2 EQ "OM. THREE 
IN THE SECOND DISPLAY. THE STATEMENT NUMBER 314000 

MNOTE • VALUE OF E£PP5 IS CPP6« 
IN THE FIRST DISPLAY WILL BE DELETED IN THE SECOND DISPLAY 

CHANGE ACTIVITY 
3 DENOTES CHANGE ACTIVITY FLAGS. D IS SYSTtM IDENTIFIER 
FOR DOS. MEANING OF THE THIRD CHARACTER IS: A = APAR, 
M = PTM, L = NEW DEVELOPMENT. ALL OTHER CHARACTERS ARE 
FOR IBM INTERNAL USE. 



28 
29 

30 
31 

32 * 

33 *01* CHANGE ACTIVITY = AS FOLLOWS. 



► CHANGE DESCRIPTIONS. 
* NFW MODULE - FIRST RELEASE 28. 
¥ 

► /* END OF SPECIFICATIONS *********************************** 
GBLA GG8LA 
GBLR CGBLB 
GBLC £GRLC 
LCLA CLCLA 
LCLB 6LCLB 
LCLC &LCLC 

ANOP 



34 
35 
36 
37 

38 

39 

40 

41 

42 

43 

44 .ONE 

45 

46 SGBLA 

47 .TWO 
48 

49 GGBLR 

50 .THREE 
51 

52 tGBLC 



AIF 

SETA 

ANOP 

AIF 

SETB 

ANOP 

AIF 

SETC 



(T'&PPl EO 
SPP1 



(T«&PP2 EO 
( 1) 



■0') .THREE 



I T 'SPP3 EO 'Q'l , 
•GPC3' 



00250000 
00300000 

0031 onoo 

00320000 
00330000 
00340000 
00342000 
00344000 
00346000 
0034R000 
00348100 
00348200 
00348600 
00349001 
00349130 
00349200 
00350900 
00352900 
00355000 
00356800 
00357?0O 
00357600 
00360900 
00361500 
0036190.1 
00364000 
00366100 
00368200 
003 7 3300 
0037*1400 
00374500 
00 376600 
00378600 
00380600 



00650000 
00701000 



OOR5Q0OO 
00900000 



E.IVPASLS 










53 


• FOUR 


ANOP 




54 




AIF 




55 


£LCLA 


SETA 




56 


.FIVE 


ANOP 




57 




AIF 




58 


ELCLB 


SETB 




59 


.SIX 


ANOP 




60 




AIF 




61 


CLCLC 


SETC 




62 


.SEVEN 


ANOP 




63 




AIF 




64 




MNOTE 




65 


•EIGHT 


ANOP 




66 




AIF 




67 




MNOTE 




6B 


.NINE 


ANOP 




69 




AIF 




70 




MNOTE 




71 


.TEN 


ANOP 




72 




AIF 




73 




MNOTE 




74 


•ELEVEN 


ANOP 




75 




MNOTE 




76 




MEND 



(T'CKWl EQ 'OM.FIVE 
£KW1 



<T«6KW2 EO 'OM.SIX 
(1) 



(T'6KW3 EQ 'OM. SEVEN 
•£KW3* 



(T'6PP4 EQ 'O'). EIGHT 

* VALUE OF ESPP4 IS SPP4* 



(T«£PP5 EQ 'OM.NINE 

• VALUE OF C&PP5 IS EPP5 ' 



(T'£PP6 EQ 'O'J.TEN 

« VALUE OF &CPP6 IS CPP6 • 



(NOT 6GBLB AND NOT 6LCLB) . ELEVEN 

1 VALUE OF C&PP2+66KW2 IS £PP2*£KW2' 



• ££PP2 AND/OR &CKW2 NOT SPECIFIED" 



00950000 
01000000 



01050000 
01100000 



01150000 
01200000 



01250000 
01300000 



01350000 
01360000 



01370000 
01450000 



01500000 
01550000 



01600000 
01750000 
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E. IVPASLS 



75/11/06 



UPDATE SURVEY 
I COL 73.6 
) VER 003000 

* IVPASLS - 5745-SC-ASM 

* IVPASLS - 5745-SC-ASM 
) VER 007000*1,8 

* TWO 

.TWO ANOP 
) REP 007500 

AIF 

AIF 
} DEL 014000 

MNOTE 
) END 



CT«CPP2 EQ 
{T'£PP2 EO 



RELEASE 28.0 
RELEASE 28.0 



•0«).TWO 
•0'). THREE 



VALUE OF £GPP5 IS £PP6 • THIS STATEMENT WILL BE DELETED 01400000 



.VERIFY CARD 
.ACTUAL STMT 



.VERIFY CARD 
.ACTUAL STMT 



.OELFTED 
.ADOFD 



END OF UPDATE SURVEY 



/* 



THIS TERMINATES THE ESERV PROCESSING 



* IVPASL COMPLETED +♦♦+++++ + ♦■++♦♦ 
EOJ IVPASL 



DATE 11/04/73 .CLOCK 07/24/59t DURATION 00/02/02 



STOP " 
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CAP - Cataloged Procedures 

This function verifies the cataloging of a procedure into the procedure library and its 
subsequent execution. 

Setup Requirement s 

A procedure library must be allocated. Eight or more unused blocks must be available in 
the member space. 

Example of SYSLOG Out put 

BG // JOB Iv/PCAPI 

DATE 11/04/73, CLOCK 07/14/36 

QQ * ************************************************************* 

BG * IDENTIFICATION : IVPCAPl 

BG * PURFOSE : CATALOGING OF A PROCEDURE 

BG * FACTIONS TESTED : CATALP 

BG * SET UP REQUIREMENTS : SYSTEM WITH PROCEDURE 

BG * LIBRARY WITH MORE THEN SIX UNUSED BLOCKS IN MEMBER SPACE 

BG * MODULES TESTED : MAINT 

BG * OUTPUT DESCRIPTION : SYSTEM STATUS REPORT PRODUCED 

BG * BY $LIBSTAT 

BG * ************************************************************** 

BG EOJ IVPCAP1 

DATE 11/04/73, CLOCK 07/16/20, DURATION 00/01 A3 
BG // JOB IVPCAP2 

DATE 11/04/73, CLOCK 07/16/28 
BG * *************************************************************** 

BG * IDENTIFICATION : IVPCAP2 

BG * PURPOSE : EXECUTION OF A CATALOGUED PROCEDURE 

BG * FUNCTIONS TESTED j EXECUTION OF CATALOGUED PROCEDURE IVPCAPl 

BG * WHEREBY AN ASSEMBLED PROGRAM IS ASSEMBLED, 

BG * LINK EDITED, TEMPORARILY CATALOGUED INTO 

BG * THE CORE IMAGE LIBRARY AND EXECUTED 

BG * SET UP REQUIREMENTS : SYSLNK, SYS001, SYS002, SYS003 MUST BE 

BG * ASSIGNED 

BG * MODULES TESTED : JOB CONTROL 

BG * OUTPUT DESCRIPTION : PRINTING OF DATA LIST 

BG * **************************************************************** 

BG * BEGIN OF PROCEDURE 

BG * END OF PROCEDURE 

BG EOP IVPCAPl 

BG IVPCAPl STARTED ++++++++++++++++-H-++++ 

BG IVPCAPl COMPLETED SUCCESSFULLY +++++++++++++++++++++++ 

BG EOJ IVPCAP2 

DATE 11/04/73, CLOCK 07/20/29, DURATION 00/03/59 
BG // JOB IVPCAP3 

DATE 11/04/73, CLOCK 07/20/36 
BG * DELETE IVPCAPl FROM PROCEDURE LIBRARY 
BG EOJ IVPCAP3 

DATE 11/04/73, CLOCK 07/21/17, DURATION 00/00/41 
BG 1C0QA ATTN. OC. 
BG 
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Example of SYSLST Output 



// JPB IVPCAP1 

* ********************************************************** 

* identification: IVPCAP1 

* purpose: cataloging of a procedure 

* functions tested: catalp 

* set up requirements: system with procedure 

* LIBRARY with more than six unused blocks in member space 

* modules tested: maint 

* output description: system status report proouced 

* by $libstat 

* ********************************************************** 
// exec maint 



DATE 04/19/74, CLOCK 09/28/22 



CATALP ivpcapi 



STATUS REPORT 



DATE: 10/28/76 



STARTING 




NEXT 




LAST 


ADDRESS 




ENTRY 




ENTRY 


C H R 


C 


H R E 


C 


H R 



TIME: 14.44 

DIRECTORY LIBRARY BLOCKS 

ENTRIES 
ACTIVE ALLOCTD ACTIVE DELETD AVAIL 



COND . DIR. TRACKS 
LIMIT OR LIBRARY 
BLOCKS CYLINDERS 



SYSRES VOL.SER.l 1 1 1 1 1 

PROCEDURE DIRECTORY 194 00 01 
LIBRARY 194 05 01 



1 94 11 08 

195 01 20 



194 04 44 
197 18 61 



// EXEC PSERV 



VERSION 0.0 



PROCEDURE LIBRARY 



* BEGIN OF FROCEDURE 
// OPTION LINK 

// EXEC ASSEMBLY 

ENTRY 

// EXEC LNKEDT 

* END OF PROCEDURE 
/ + 



EOJ IVPCAPI 



DATE 04/1 9/74. CLOCK 09/28/35, DURAT ION OO/OO/i; 



// JOB IVPCAP2 

* ********************************************************** 

* IDENTIFICATION: IVPCAP2 

* PURPOSE: EXECUTION OF A CATALOGUED PROCEDURE 

* FUNCTIONS TESTED: EXECUTION OF CATALOGUED PROCEDURE IVPCAPI 

* WHEREBY AN ASSEMBLER PROGRAM IS ASSEMBLED, 

* LINK EDITED, TEMPORARILY CATALOGUED INTO 

* THE CORE IMAGE LIBRARY AND EXECUTED 

* SET UP REQUIREMENTS: SYSLNK, SYSOO 1 .SYSOO 2.SYS003 MUST BE 

* ASSIGNED 

* MODULES TESTED: JOB CCNTROL 

* OUTPUT DESCRIPTION: PRINTING OF DATA LIST 

* ******************** ******************* ******************** 
// EXEC PROC= IVPCAPI 

* BEGIN OF PRCCEDURE 
// OPTION LINK 

// EXEC ASSEMBLY 



DATE 04/1 9/74. CLOCK 09/28/37 
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EXTERNAL SYMeOL DICTIONARY 



SYMBOL 



TYPE 



TEST SD (CSECT) 

IJDFZ22Z ER (EXTRN) 

IJDF222Z SC (CSECT) 

IJC-2IZ0 ER (EXTRN) 



ID ADDR LENGTH LD-ID 

01 007DOO OOOICO 

02 

03 OOOO00 000028 

04 



SYMBOL ID LENGTH 

IJDP0012 FF. 000030 



DUMMY SECTION DICTIONARY 



LOC OBJECT COOE 
007DOO 



ADDR1 AD0R2 STMT 



SOURCE STATEMENT 



DOS/VS ASSEMBLER REL 30.0 05.29 74-04-19 



007D00 OSAO 

007D02 4 1 BO A0D8 

007D06 181B 
007D08 OAOC 

007D0A 181B 

007DOC 9180 1002 

007D1 471 A014 

007014 OA07 

007D16 0700 

007D16 

007D18 4110 A1A6 

007D1C 4500 A026 

007D20 00007CA8 

007D24 00007078 

007028 0A02 



07D02 
07DDA 



00002 
07D16 



07EA8 
07D2 8 



1 TEST START 32000 

2 IVPCAPS 

3+* IVPCAPS - 5754-SC-LBR - RELEASE 28.0 

4+* 

S+* /* START OF SPECIFICATIONS ****************************************** 

6+* 

7+*0 1* MODULE-NAME= IVPCAPS 

8+* 

9+*01* DESCRIPTI VE-NAME=INSTALLATI ON VERIFICATION PROCEDURE 
10+* TEST FOR CATALOGUED PROCEDURES 

1 1 + * 

12+*01* NOTES = CHANGE ACTIVITY 

13+* a DENOTES CHANGE ACTIVITY FLAG. D IS SYSTEM IDENTIFIER FOR DOS. 

14+* MEANING OF THE THIRD CHARACTER IS - A = APAR ,M=PTM. I=NEW 

15+* DEVELOPMENT. OTHER CHARACTERS ARE FOR IBM INTERNAL USE. 

16+* 

17+*01* CHANGE ACTIVITY = AS FOLLOWS 
18+* CHANGE DESCRIPTIONS 

19+* NEW MODULE - FIRST RELEASE 28 

20+* WRONG SEARCH IN PCIL 

21+* 

22+**** END OF SPECIFICATIONS *******************************************/ 
23+START BALR 10.0 

24+ USING *.10 

25+ LA REG.TYPECCB 

26+* SUPVR COMMN MACOS - EXCP - 5745-SC-SUP - REL. 28.0 



2 7+ LR 

28+ SVC 

29+* SUPERVISOR 



,REG 



30+ 

31 + 

32 + 

33+ 

34+* IOCS - 

3 5+ 

36+ 

37 + 

38+IJJ00004 

39 + 

40+ 

41+ 



WAIT - 5745-SC-SUP - REL, 

LR 1 .REG 
TM 2( 1 ).X«80» 

EO *+6 

SVC 7 

OPEN - 5745-SC-IOX - REL 28.0 

CNOP 0.4 

DC OF • • 
LA l,=C'$$EOPEN • 

BAL 0.*+4+4*(3-l ) 

DC A( INPUT) 

DC A(OUTPUT) 

SVC 2 



EM 



04000028 
05000028 
06000028 
07000028 
08000028 
09000028 
10000028 
1 1000028 
12C0002E 
13000028 
14000028 
15000028 
16000026 
17000C2€ 
18000028 
19000028 
2C0O002e 
21000028 
22000028 
23000028 
24000028 
25000C26 
26000028 
150 50028 
50000025 
55010028 
12000028 
39000025 
54000025 
57000025 
60000025 
12000028 
20000025 
22000025 
46000025 
54000025 
64000025 
64000025 
74000025 



00702A 5810 A1B6 

007D2E 58F1 0010 

007D32 4SEF 0008 

007D36 5810 Al Efi 

007D3A 58F1 0010 

007D3E 45EF OOOC 



07EB8 
00010 
00008 

07EBC 
00010 
OOOOC 



43+* IOCS - GET - 5745-SC-IOX - REL 29.0 

44+LABEL L l.=A(INPUT) GET DTF TABLE ADDRESS 

45+ L 15.16(1) GET LOGIC MODULE ADCRESS 

46+ EAL 14.8(15) BRANCH TO GET ROUTINE 

47+* IOCS AND DEVICE INDEPENDENT I/O - PUT - 5745-SC-IOX - REL. 29.0 

48+ L l,=A(OUTPUT) GET DTF TABLE ADCRESS 

49+ L 15.16(1) GET LOGIC MODULE ADDRESS 



50+ 



BAL 



14. 12< 15) 



BRANCH TO PUT ROUTINE 



12000029 
42000025 
75000025 
78000025 
05000029 
15000025 
3-5 54000025 
3-5 55000025 
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LOC OBJECT CODE 



ACOR1 ADOR2 STMT 



SOURCE STATEMENT 



OOS/VS ASSEMBLER REL 30.0 09.29 74-04-19 



007D42 47F0 A 028 07D2A 

0073*6 700 
00 7D*8 

007D48 411C A1AE 

007D4C 4500 AC56 

0070?0 00007DA8 

007D54 00007D78 

00 7D58 0A02 

007D5 A 4 1 BO A0F6 

00705E 5 0B0 AOEO 

*** EFROR *** 

00 7D6 2 41 BO A0D8 

007D66 181B 

007D68 OAOO 

007D6A 181B 

007D6C 9180 1002 00002 

007D70 4710 AC74 07D76 

007074 0A07 

007076 OAOE 





51 + 






B 


LABEL 




52+* 


IOCS 


AND DEVICE I NDE PENDANT 




53 + 






CNOP 


0.4 




54+ END 




DC 


OF* 0' 


07EB0 


55+ 






LA 


l.=C*$$BCLOSE« 


07058 


56+1 JJC0007 


BAL 0. *+4+4*<3-l > 




57+ 






DC 


A(INPUT) 




58+ 






DC 


A(OUTPUT) 




5 9+ 






SVC 


2 


07DF8 


60+ 






LA 


REG.TYPNCCW 


07DE2 


61 + 






ST 


REG.TYPECCB+8 



I/O - CLOSE - 5745-SC-IOX - R EL . 28.0 



62+ LA REG.TYPECCB 

63+* SUPVR COMMN MACOS - EXCP - 5745-SC-SUP - REL. 28.0 



5745-SC-SUP 



64+ 


LR 


1 .REG 


65+ 


SVC 





66+* 


SUPERVISOR ■ 


- WAIT - 574 


67+ 


LR 


1 .REG 


68+ 


TM 


2( i ),x« ec 


69+ 


BO 


*+6 


70+ 


SVC 


7 



71+* SUPVR COMMN MACROS - EOJ - 5745-SC-SUP - REL. 28.0 



3300002e 
0810002G 
20000025 
E200C025 
46000025 
54000025 
64000025 
64000025 
74000025 
35000028 
36000028 

36050028 
15050028 
5000002S 
EM 55010028 
12000028 
39000025 
54000025 
57000025 
60000025 
40000028 
50C0C02E 



74+* IOCS AND DEVICE INDEPENDANT I/O - DTFPR - 5745-SC-IOX 



REL. 30.0 



007D"'8 

007D78 000080COOOOO 

007D7E 00 

007D7F 03 

C07D80 00007DAO 

007D8* 00000000 

007D88 00 

007D89 000000 

007D8C 08 

0C7D8D 10 

C07D8E 09 

007D8F 09 

C07D90 00007E58 

00709* OOOOCOOO 

007096 0700 

007D9A 470C 0000 OC 

007D9E OOOC 

0070AO 09007E5620000050 



oooorr 

C00000 
C000C2 
000003 
COOOO* 



75 + 

76+OUTPLT 
77 + 



DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 

DC 
DC 

NOPR 
NOP 
CC 

CCW 



OD'O' 

x'ooooaooooooo' 

ALKO) 

AL1 (3) 

A(*+32) 

4X'00« 

AL1 (0) 

VL3(I JDFZZZZ) 
X'08« 
AL1 (16) 
ALK9) 
AL1 (9> 

A( IN+O) 
4X«00' 



2X»00" 
9,IN+0.X'20* .80-0 



78+ 

79+ 

80+ 

81 + 

82+ 

83+ 

84+ 

85+ 

86+ 

87+ 

88+ 

89+ 

90+ 

91 + 

9 2+ 

93+IJJZ0011 EQU * 

94+* IOCS AND DEVICE INDEPENDANT I/O 

95+IJDPD012 DSECT 

DS CL2 

DS CL1 

DS CL1 

DS CL2 



RES. CCUNT, COM. BYTES BTS JJ 
LOGICAL UNIT CLASS 
LOGICAL UNIT 

CCW ADOR. JJ 

CCB-ST BYTE.CSW CC* ADDRESS JJ 

SWITCH 3 4-0 

ADDR OF LOGIC M0DUL3-8 



DTF TYPE (PRINTER) JJ 

SWITCHES 

NORMAL COMM. CCCE 4-0 

CONTROL COMM. CODE 4-0 

ADDRESS OF DATA IN IOAREA1 

BUCKET 3-5 

PUT LENGTH IN REG12 (ONLY UNDEF. 
LOAD USER POINTER REG 

NOT USED 3-5 

4-0 



- PRMOD - 5745-SC-IOX 



REL. 2 9.0 



96+IJCP0012 
97+ I J DPI 01 2 
98+IJDP2012 
99+IJDP0012 



RESIDUAL COUNT 
COMMUNICATION BYTE 1 
COMMUNICATION BYTE 2 
CSW STATUS BYTES 



02870030 
60000025 

eisioo2e 

70000025 
7C200028 
71000028 
71200028 
7175C027 
76800025 
77580028 
7760CC25 
78000027 
78400027 
76800025 
64000025 
84600025 
86400025 
89600025 
91200027 
92000025 
01290029 
16200025 
16400025 
16600025 
16800025 
17000025 



150 DOS/VS System Generation 



LOC OBJECT CODE 



ADDR1 ADDR2 STMT 



SOURCE STATEMENT 



DOS/VS ASSEMBLER REL 30.0 09.29 74-04-19 



ooooee 
cooooa 

000009 

cooooc 

C00O0D 
00001C 
000014 
0000 15 
000016 

00001 7 

00001 8 

ooooic 

000020 
000022 
000026 
000027 
000028 
000029 
00002C 
00002D 
00002E 
OOOOOC 



000000 CA32 

C00002 0000 

000004 0A32 

C00006 0000 

000008 0A32 

OOOOOA OOOC 

OOOOOC 47F0 F01A 

000010 C9D1C4C6E9E9E9E9 

000018 2800 

00001A OAOO 
OC 001C 9180 1C02 
000020 4710 F026 
C00024 OA07 
000026 07FE 





100+IJDP3012 


DS 


CL2 


LOGICAL UNIT ADDRESS 








17200025 




101 + 


OS 


CL1 


NOT USED 










17400025 




102+1 JDP4012 


DS 


CL3 


ADDRESS CF CCW 










17600025 




10 3+ 


OS 


CL1 


STATUS BYTE 










17800025 




104+ 


DS 


CL3 


CSW CCW AC DR. 










18000025 




105+UDM1012 


DS 


CL4 


ADDRESS OF LOGIC MODULE 4- 


■0 


18050027 




106+IJDP5012 


DS 


CL1 


DTF TYPE 










18400025 




107+IJDP6012 


DS 


CL1 


SWITCHES 










ieeocc2S 




108+IJDP9012 


DS 


CLl 


NORMAL COMMAND CODE 








18800025 




109+IJDPA0 12 


DS 


CL 1 


CONTROL COMMAND CCDE 








19000025 




110+IJDP7012 


OS 


CL4 


ADDRESS OF IOARE* 1 








19200025 




11 1 + IJDP8012 


DS 


CL4 


BUCKET 










19400025 




112+1 JCPE012 


OS 


CL2 


L l2t4RECSIZE 










19600025 




113+IJDPC012 


DS 


CL4 


LA &IOREG.0U4) 










19800025 




114+IJCPE012 


DS 


CLl 


BUCKET FOR PRTOV 


IF ASA 


CH 


9 




20000025 




1 1S+IJDPF012 


DS 


CLl 


BUCKET FOR PRTOV 


IF ASA 


CH 


12 




20200025 




116+IJDPG012 


DS 


CLl 


COMMAND CODE 










21000025 




117 + IJDPKM2 


DS 


CL3 


ADDRESS IOAREA 2 










21200025 




118+IJDPI 012 


DS 


CLl 


FLAGS =X*20' 










21400025 




119+ 


DS 


CLl 


NOT USED 










21600025 




120+IJDPJ012 


DS 


CL2 


COUNT 










21800025 




121+IJDFZZZZ 


CSECT 














22000025 


00000 


122 + 


USING 


IJDP0012. 1 












24800025 


coooo 


123+ 


USING 


*.15 












2S00CC25 




124+ 


SVC 


IJDL6012 


CONTROL ERROR 










26000025 




125 + 


DC 


lH^O" 












26200025 




126+ 


SVC 


I J0L6012 


PRTOV ERROR 










27000025 




127+ 


DC 


1H«0« 












27200025 




128+ 


SVC 


IJDL60 12 


GET ERROR 










27400025 




129+ 


DC 


1H« 0' 












27600025 


0001 A 


13C + 


B 


UDPR012 


BRANCH TO PUT 










27800025 


9 


131 + 


OC 


CL8«IJDFZZZZ» 


MODULE NAME 






4- 


-0 


2800CC27 




132+ 


DC 


X«2800» MODULE 


CHANGE LEVEL 




3DM014 57 


280 5002e 


0001 A 


133+IJDPR012 


EQU 


* 












28400025 




134+ 


SVC 


IJDL7012 


EXCP 










seeooc2£ 


00002 


135+ 


TM 


IJOPt012.IJDL8012 


WAIT CHANNEL END 






4- 


-0 


59400027 


00026 


136+ 
137+ 


BO 
SVC 


*+6 

7 












59600025 
5980002S 




136 + 


BR 


IJDL4012 


BACK TO USER 






3-9 


60250026 


OOOOB 


139+IJDL1012 


EQU 


1 1 


REG 1 1 






3- 


■3 


69600025 


OOOOC 


140+IJDL2012 


EQU 


12 


REG 12 










70000025 


OOOOD 


141+IJCL3012 


EQU 


13 


REG 13 










70200025 


OOOOE 


14 2+IJDL4012 


EOU 


14 


REG 14 










7C400025 


OOOOF 


143+IJDL5012 


EQU 


15 


REG 15 










70600025 


00032 


144+IJDL6012 


EQU 


50 


ABEOJ 










70800025 


00000 


145+1JDL7012 


EQU 





EXCP 










71000025 


00080 


146+IJ0L8012 


EQU 


x»e0' 












71200025 


00040 


147+IJDLS012 


EQU 


X»40« 












71400025 


00020 


148+IJDLA012 


EQU 


X« 20« 












71600025 


00008 


149 + IJCLE012 


EQU 


X«08» 












71800025 


00010 


150+1 JDLC012 


EQU 


X« 10« 












72000025 
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LOC OBJECT CODE 



ACDR1 ADDR 2 STMT 



SOURCE STATEMENT 



DOS/VS ASSEMBLER REL 30.0 09.29 74-04-19 



00004 
00006 
00 00 1 
00002 
00068 
000FE 
0000B 
OOOBF 
000F8 
00040 
0000 1 
00015 
00038 
00023 
00005 
0008D 
OOOBD 
0001D 
OOOOD 
OOOCD 
00030 



007DA8 

007DA8 

007DA8 OC008O0000O0 

00 70 A E 

007DAF 1 

0070B0 00007DC8 

007DB* 00000000 

007DB8 00 

007089 000000 

007OBC C2 

007DBD OC 

007DPE 02 

007DBF 02 

007DCO 00007E58 

007OC4 00 

007DC5 007D48 

007DC8 02007E5e2C000050 

007DD0 4700 0000 'COOOO 

007DD4 4700 0000 00000 

007DD8 0000 



07DDA 



0070DA OOOC 

007DOC 0000 

0070DE 0000 

007DEO OC 

007DE1 04 

007DE2 00 

007DE3 007DFO 



15 1+IJDLC0 12 
IS2+IJDLE012 
153+IJDLF012 
154+1 JDLG012 
155+1 JDLH012 
156+IJDL 10 12 
157+1 JDLJ012 
158+IJDLK012 
159 + IJCLL012 
160+IJDLM012 
161+IJDLN012 
162+IJDM6012 
163+1 JDM6012 
164+IJCJM012 
165+1 JD05012 
166+IJD8D012 
167 + IJCBC012 
168+1JD1D012 
169+IJD0D012 
170+1 JDCD012 
171+1 JDV2012 
172+TEST 



EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
CSECT 



X'04' 
X«06* 
X'Ol* 
X»02« 
X" 8B» 
X«FE« 
X'OE' 
X'BF* 
X'F8« 
X'40' 
I 
X' 1 5' 
56 

X«23» 
X«05« 
X'8D' 
X'BD* 
X* ID" 
X«0D« 
X" CD* 
48 



CCB+3 ERROR PASSBACK BITS 3-9 

CCB+2 ERROR PASSBACK BITS 3-9 

REG 1 3-9 

DISP FOR SWITCHES 4-0 

ASOCFLE CISP IN CTF 4-0 

FDiSS COMMAND 4-0 
LINE POSITION ZERO FOR 3525 4-0 

TEST FOR CHANNEL 9 4-0 

TEST FOR CHANNEL 12 4-0 

LINE 3 4-0 

LINE 1 4-0 

LINE 26 4-0 

DISP IN FUNCH DTF 4-0 



173+* IOCS AND DEVICE INDEPENDANT I/O - DTFCO - 574E-SC-I0X - REL. 30.0 



174+ 

175+INPUT 

176+ 

177 + 

178 + 
179+ 

180 + 

181 + 
182+ 
183 + 
184+ 
185+ 
186+ 
187+ 
188 + 

189+IJCX0013 
190+ 
191 + 
192+ 
193+IJ JZOO 13 EQU * 

194+* SUPVR COMMN MACROS - CCB - 5745-SC-SUP - REL. 28.0 



DC 
DC 
DC 
DC 
DC 

DC 
CC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 

CCW 
NOP 
NOP 
DC 



0D*0« 

X •000080000000' 

AL1 (0) 

AL 1 ( 1 ) 

A( IJCX0013) 

4X' 00' 
ALKO) 

VL3 { IJCFZIZO ) 
X'02« 
AL1 (0 ) 
AL1 (2) 
AL 1( 2) 
A( IN) 
AL1 (0) 
AL3CEND) 

2. IN.X '20* .80 



x> oooo* 



RES. COUNT, COM. B\TES STATUJJ 
LOGICAL UNIT CLASS 
LOGICAL LNIT 

CCW ADDRESS BDL2994J 

CCB-ST BYTE.CSW CCW ADDR . 
SWITCH 3 4-0 

ADDRESS OF LOGIC MODULE 3-3 

DTF TYPE (READER) JJ 

SWITCHES 

NORMAL COMM.CODE 
CNTROL CCMM.CODE 
ADDR. OF IOAREA1 

JJ 
EOF ADDRESS JJ 

LOAD USER POINTER REG. 
MOVE IOAREA TO WCRKA 



195+TYPECCB 

196+ 

197+ 

198+ 

199 + 

200+ 

20 1 + 



DC 
DC 
DC 
DC 
DC 
DC 
DC 



XL2-0' . 

XL2>0' 

XL2»0« . 

AL1(0) 

AL1(4> 

XL1 *0* 

AL3(TYPECCW) 



RESIDUAL COUNT 

COMMUN1CATI CNS BYTES 
CSW STATUS BYTES 

LOGICAL UNIT CLASS 
LOGICAL UNIT 

CCW ADDRESS 



72200025 
7240CC2S 
72600025 
72800025 
73000025 
73200025 
7340C02E 
73600025 
73650026 
73700026 
73750026 
73750527 
73751027 
73751527 
73752027 
73752527 
73753027 
73753527 
73754027 
73754 52 7 
73755027 
75800025 
01220030 
44800025 
45200028 
49800025 
50000025 
50400029 
51C00025 
51200027 
53600025 
53940028 
55200025 
5S40C025 
59600025 
60000025 
60600028 
60800028 
62600025 
63000025 
63800025 
64000025 
85800025 
07100028 
49000028 
50000028 
E100002e 
52000028 
53000028 
540OCC28 
55000028 



152 DOS/VS System Generation 



LOC OBJECT CODE 



ADDR1 ADDR2 STMT 



SOURCE STATEMENT 



DOS/VS ASSEMBLER RE L 30.0 09.29 74-04-19 



007DE6 00 

0070E7 OO0000 

007DEA OOOOCOOCOOOO 

0070FO 09007EOC00000025 

007DF8 09007E2500000033 

C07E00 C9E507C3C1D74040 

007E25 C9E5D7C3C1D74040 

007E58 

0C7EA8 5B5BC2D6C7C5D540 

007FB0 5B5BC2C3D3D6E2C5 

007EB8 00007DA8 

007EBC 00007D78 



20 2+ 

20 3+ 



DC 
CC 



B* 00000000' 
AL3(0) . 



STATUS BYTE 
CSW CCW ADDRESS 



204+TYPECCW CCW 9.MSGST .0 .L' MSGST 



205+TYPNCCW 

206+MSGST 

2 07+ MS GEN 

208+REG 

209+IN 

210 

21 1 

212 

213 

214 



CCW 9,MSGEN,0,L'MSGEN 

OC CMVPCAP STARTED ++++++++++++♦+++♦+++• 

DC C'lVPCAP COMPLETED SUCCESSFULLY ++++++++++++++++++++' 

EQU 1 1 

CS CL80 

END START 

=C«$$BOPEN • 

= C , $$ , BCLOSE' 

=A( INPUT) 

=A(OUTPUT ) 



56000028 
57000028 

45000028 
46000028 
4700C02C 
48000028 
49000028 
50000028 



RELOCATION DICTIONARY 



ESDID FOR 


ESDID FOR 


TYPE 


LENGTH 


ADDRESS 


ADDR CON 


REF SYMBOL 








C 1 


+ 01 


A 


4 


007D20 


01 


+ C1 


A 


4 


007D24 


1 


+ 01 


A 


4 


007DE0 


01 


+ 01 


A 


4 


007D54 


01 


+ 01 


A 


4 


00 7D80 


01 


+02 


V 


3 


007DC9 


01 


+ 01 


A 


4 


007D90 


01 


+ 01 


CCW 


3 


007DA1 


01 


+01 


A 


4 


007DBO 


01 


+ 04 


V 


3 


007DE9 


01 


+ 01 


A 


4 


007DC0 


01 


+01 


A 


3 


007DC5 


01 


+ 01 


CCW 


3 


007DC9 


1 


+ 01 


A 


3 


007DE3 


01 


+ 01 


CCW 


3 


007DF1 


01 


+ 01 


CCW 


3 


007DF9 


Oi 


+ 01 


A 


4 


007EB8 


01 


+ 01 


A 


4 


007EEC 
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CROSS-REFERENCE PAGE 6 

SYMBOL LEN ID VALUE DEFN REFERENCES 74-04-19 

END 00004 01 007D48 00054 0188 

IJCX0013 00008 CI 007DC6 00189 017e 

IJDBD012 00001 OOOOBD 00167 

IJDCD012 00001 OOOOCD 00170 

IJDFZ2ZZ 00001 03 OOOOCO 00121 

IJDJM012 00001 000023 00164 

IJDLA012 00001 OC0020 00148 

IJDL6012 00001 OOOOOe 00149 

IJDLC012 00001 000010 00150 

IJDLD012 00001 000004 00151 

IJDLE012 00001 000006 00152 

IJDLF012 00001 000001 00153 

IJDLG012 00001 000002 00154 

IJDLH012 00001 00008E 00155 

IJDLI012 00001 OOOOFE 00156 

IJDLJ012 00001 OOOOOB 00157 

IJDLK012 00001 OOOOBF C0158 

IJDLL012 00001 OOO0F8 00159 

IJDLM012 00001 000040 00160 

IJ0LN012 00001 000001 00161 

IJDL1012 00001 OOOOOB 00139 

1JDL2012 00001 OOOOOC 00140 

IJDL3012 00001 OOOOOD 00141 

IJDL4012 00001 OOOOOE 00142 0138 

IJDL5012 00001 OOOOOF 00143 

IJDL6012 00001 000C32 00144 0124 0126 0128 

IJDL7012 00001 000000 00145 0134 

IJDL6012 00001 000080 00146 0135 

IJDL9012 00001 000040 00147 

UOM1012 00004 FF 000010 00105 

IJDM6012 0COO1 000015 00162 

IJDM8012 00001 000038 00163 

IJDPA012 00001 FF 000017 00109 

IJDPBC12 00002 FF 000020 00112 

U0PC012 00004 FF 000022 00113 

IJDPD012 00001 FF OOOOCO 00095 

IJDPE012 00001 FF 000026 00114 

UDPF012 00001 FF 000027 00115 

IJDPG012 00001 FF 000028 00116 

1JDPH012 OCC03 FF 000029 00117 

IJDPI012 00001 FF 00002C 00118 

IJDPJ012 0C002 FF 00002E 00120 

IJDP0012 00002 FF 000004 00099 

IJDPR012 0C001 03 00001A 00133 0130 

IJDP0012 00002 FF 000000 00096 0122 

IJDP1012 00001 FF 000002 00097 0135 

IJDP2012 00001 FF 000003 00098 

IJOP3012 00002 FF 0000C6 00100 

IJDP4012 00003 FF 0000C9 00102 

IJOP5012 0C001 FF 000014 00106 

IJDP6012 00001 FF 000015 00107 



154 DOS/VS System Generation 



CROSS-REFERENCE 



LEN ID VALUE DEFN 



REFERENCES 



74-04-19 



IJDP7012 


00004 


FF 


000018 


001 10 








IJDP8012 


00004 


FF 


00001C 


001 11 








IJDP9012 


OOOOX 


FF 


ooooie 


00108 








I JDV2012 


00001 




000030 


00171 








IJO0D012 


00001 




OOOOOD 


00165 








IJD05012 


00001 




000005 


00165 








I JD1D012 


00001 




000010 


00168 








IJD8D012 


00001 




00008D 


00166 








I JJC0007 


00004 


01 


007 04 C 


00056 








I JJOO004 


OOC04 


CI 


007D1C 


00038 








IJJZ0011 


00001 


01 


007DA8 


00093 








IJJZ0013 


00001 


01 


007DDA 


00193 








IN 


00C80 


01 


007E5C 


00209 


ooe7 


0092 


0186 


INPUT 


00006 


01 


007DA8 


00175 


0039 


0057 


C213 


LABEL 


00004 


01 


007D2A 


00044 


0051 






MS GEN 


00051 


01 


007E25 


00207 


0205 


02 05 




MSGST 


00037 


01 


007E00 


00206 


0204 


0204 




OUTPUT 


00C06 


CI 


007D78 


00076 


004 


0058 


0214 


REG 


00001 




000 OB 


00208 


0025 


0027 


0030 


START 


00002 


01 


007DCO 


00023 


0210 






TEST 


00001 


01 


007DC0 


00001 


0172 






TYPECCe 


00002 


01 


007DDA 


00195 


0025 


0061 


C062 


TYPECCW 


00008 


01 


007DFO 


00204 


0201 






TYPNCCVY 


00008 


01 


007DF6 


00205 


0060 






=A< INPUT ) 
















00004 


CI 


007EB8 


00213 


0044 






=A (OUTPUT) 
















00004 


01 


007EEC 


00214 


0048 






=C«$>BOPEN • 
















00008 


01 


007EA8 


00211 


0037 






=C'$$BCLOSE« 
















00C08 


01 


007EBC 


00212 


0055 







0060 0061 0062 0064 0067 
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DIAGNOSTICS ANC STATISTICS 



PAGE 10 



STMNT ERROR NO. MESSAGE 

61 IPK182 ALIGNMENT ERROR IN OPERAND 2 



74- 04- IS 



THE FOLLOWING MACRO NAMES HAVE BEEN FOUND IN MACRO INSTR.UC TI ONS 
IVPCAPS EXCP WAIT OPEN GET PUT CLOSE 



OPTIONS FOR THIS ASSEMBLY - ALIGN. LIST, XREF. LINK. DECK. EDECK 



THE ASSEMBLER WAS RUN IK 13504e BYTES 
END OF ASSEMBLY 



ENTRY 
// EXEC LNKEDT 



JOB IVPCAP2 04/19/74 

ACTION TAKEN MAP REL 
LIST AUTOLINK IJCFZIZO 

LIST ENTRY 



DOS LINKAGE EDITOR DIAGNOSTIC OF INPUT 



04/19/74 PHASE XFR-AD LOCORE HICORE DSK-AD ESD TYPE LABEL LOADED REL-FR 

PHASE*** 040078 040078 0402CB 019 OD 09 CSECT TEST 040078 038378 RELOCATABLE 

CSECT UDFZZZZ 040238 040238 

CSECT IJCFZIZO 040260 040260 



*■ END OF PROCEDURE 
EOP IVPCAP1 
// EXEC 
t 

12 
. 123 
1234 
12 345 
123456 
1234567 
12345678 
123456789 



EOJ IVPCAP2 



DATE 04/19/74. CLOCK 09/30/26. DURATION 00/01/S1 



// JOB IVPCAP3 

* DELETE IVPCAP1 FROM PROCEDURE LIBRARY 

// EXEC MA INT 



DATE 04/ 19/74. CLOCK 09/30/3 



DELETP IVPCAP1 



STATUS REPORT 



1TARTING 




NEXT 


ADDRESS 




ENTRY 


C H R 


C 


H R 



DATE: 10/28/76 TIME: 14.44 

LAST DIRECTORY LIBRARY BLOCKS COND. DIR. TRACKS 

ENTRY ENTRIES LIMIT °* LIBRARY 

C H R E ACTIVE ALLOCTD ACTIVE DELETD AVAIL BLOCKS CYLINDERS 



SYSRES VOL.SER. HI 111 
PROCEDURE DIRECTORY 

LIBRARY 



194 00 01 194 OC 11 08 1 94 04 44 09 

194 05 01 195 1 20 197 18 61 



EOJ IVPCAP3 



DATE 04/19/74. CLOCK 09/3C/3S.DURA TION 00/00/05 
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EMA - 1401/1440/1460 Emulator 



Functions Tested 

Three verification procedures are provided with the emulator: 

• One to be used with an emulator generated for a 1401 or a 1460, with the following 
options: advanced programming, sense switches, and 1400 console. 

• One to be used with an emulator generated for a 1401 or a 1401G or a 1460 without the 
above options. 

• One to be used with an emulator generated for a 1440 with the options advanced 
programming and sense switches. 



IVPGEN MACRO OPTIONS 

I NO) Specify if the DOS/VS 1401/1440/1460 Emulator program is to be 
EMA=\yes( verified. 

R equired Parameters 

(1401 ) 
EMATYPE=<1440 / Specify the required verification procedure. 



1401G 



1401 
1440 
1401G 



Verification procedure for a 1401/1460 emulator with options. 
Verification procedure for a 1440 emulator. 

Verification procedure -for a 1410/1460 emulator without options, 
or verification procedure for a 1401G emulator. 



EMANAME=X Specify the phasename under which the emulator is cataloged in the core 
image library. 

Optional Parameters 

EMACCS=| NO) Specify if CS control cards support is required in the user-generated 

(YES) 1401/1440/1460 emulator program (CTLCARD=CS specified in the EMSUP macro 
instruction) . 

Specify the following two parameters only if you want to verify the tape functions. 

EMATSN=SYSnnn Specify the logical name of the tape device assigned to the 14 00 tape 
unit 1. This unit must have been defined in an EM TAPE emulator macro 
instruction. Do not specify this parameter if spanned tape format has 
been specified <TPSUP=SPANNED in the EMSUP emulator macro instruction) , 
or if the emulator does not emulate the tapes (TPSUP=NCNE in the EMSUP 
macro instruction). 

EMATA=cuu Device address of the tape drive. Specify only if EMATSN^SYSnnn is also 
specified. 

Note that only one emulator program can be executed during one IVP run and that, 
conversely,, this emulator can execute only one of the verification procedures. 

In addition to testing the 1400 CPU functions and the operator communication 
functions,, the verification procedures: 

• Read data from the System/370 device assigned as 1400 card reader. 

• Punch data on the System/370 device assigned as 14 00 card punch. 

• Print the data read from the 1400 card reader on the System/370 device assigned as 
1400 printer. 
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If the System/370 configuration includes a tape unit, the verification procedures (except 
those for the 1401G or the 1401/1460 without options) optionally write on and read from 
tape in 1400 format (TPSUP=ORIGINAL or MIXED in the EMSUP emulator macro instruction) . 

The verification procedures contain 1400 object programs and data as well as tne 
DOS/VS control cards required to execute the emulator. You can perform the verification 
procedures with the emulator generated in accordance with your specifications and 
cataloged to the core image library. 

However, the verification procedures cannot be used with an emulator generated to 
handle: 

• column binary data 

• card image data 

• 51-column cards. 

A 1401/1440/1460 emulator must emulate real storage of a size of at least 4,000 bytes. 
A 1401G emulator must emulate real storage of a size of at least 4,000 bytes. 

SOFTWARE REQUIREMENTS 

Emulator Macro Options 

The following emulator instructions generate a minimum emulator to execute the 
verification procedures (does not apply to the 1401G emulator) : 

EMULATOR CPU=XXXX , CORE= 4 , ADVPROG= YE S , SENSE SW=YES , MODEL=l 4 5 

EMSUP EMNAME=EMSPL01 ; ,CCRDR=SYSRDR„ X 

TPSUP=ORIGINAL,CONSOLE=YES 
EMRDR TODEV=2540 

EMPNCH FRCMDEV=140 2,TODEV=254 
EMPTR FRCMDEV=1403,TODEV=1403 

EMTAPE DEVADDR=SYS001,UNIT=1, X 

TYPEFLE=OUTPUT,,RECFM=ORIGINAL 1 ,ELKSIZE=8 
EMEND 
END 

Notes 

1. xxxx in the EMULATOR macro can be either 1401,1440, or 1460. 

2. The EMTAPE macro specification is not required if no tape functions are to be 
verified. 

For a 1401G the minimum emulator is generated as follows: 

EMULATOR CPU=14 01G„CORE=4 ,ADVPROG=YES, SENSESW=YES, MODEL=14 5 

EMSUP EMNAME=EMSPL01,CCRDR=SYSRDR 

EMRDR TODEV=2540 

EMPNCH FRCMDEV=1402,TODEV=2540 

EMPTR FROMDEV=1403, TODEV=1403 

EMEND 

END 

The logical names of the System/370 devices assigned as 1400 reader, punch, and printer 
are by default SYSIPT, SYSPCH, and SYSLST. If you specified logical names in the form 
DEVADDR=SYSnnn w be sure that these devices relate to the same devices as SYSIPT, SYSPCH, 
and SYSLST. 
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HARDWARE REQUIREMENTS 

A Central Processing Unit equipped with: 

• The IBM Compatibility Feature 4457 for Models 125 and 135 

• The IBM Compatibility Feature 4457 or 4458 for Model 145 

• Standard instruction set 

• One tape drive, if the tape functions are to be verified 

STORAGE REQUIREMENTS 

The amount of storage required depends on what you specify when generating your emulator. 
The emulator described in the section "Software Requirements'* takes up approximately 
27,500 bytes of storage. 

OPERATING INSTRUCTIONS 

1 . Setup Requiremen ts 

None, if tape functions are not to be verified. Otherwise, mount a scratch tape on 
the tape unit assigned to 14 00 tape unit 1. 

2. Operating Instructions 

Type in START in response to message 

EN0 21D IVPEMA HALT IAR=nnnnnn 
AAR=00001/2 EAR=00001/2 



EMB - 1410/7010 Emulator 



Functions Tested 

• 1410/7010 CPU functions 

• Operator communication functions 

• Console operations 

• Tape functions - 1400 format (optional) 

IVPGEN MACRO OPTIONS 

EMB=f NO) Specify if the DOS/VS 1410/7010 Emulator program is to be 
lYES/ verified. 

Required Parameter 

EMBNAME=x Specify the phase name under which the emulator is cataloged in the core 
image library. 

Optional Parameters 

EMBTSN=SYSnnn Specify the logical name of the System/370 tape device assigned to 1400 
tape unit 1, channel 1. 

EMBTA=cuu Eevice address of the tape drive. Specify only if EMATSN=SYSnnn is also 
specif ied- 
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In addition to testing the 1410/7010 CPU functions and the operator communication 
functions, the verification procedures: 

• Read data from the System/370 device assigned as 1400 card reader. 

• Punch data on the System/370 device assigned as 14 00 card punch. 

• Print the data read from the 1400 card reader on the System/370 device assigned as 
1400 printer. 

If the System/370 configuration includes a tape unit the verification procedures 
optionally write on and read from tape in 1400 format (TPSUP=ORIGINAL or MIXED in the 
EMSUP emulator macro instruction) . 

The verification procedure comprises a 1400 object program and data as well as the 
DOS/VS control cards required to execute the emulator program. You can perform the 
verification procedures with an emulator generated in accordance with your specifications 
and cataloged to the core image library. 

The minimum amount of storage that can be handled by a 1410/7010 emulator is 40,000 
bytes. 

For a 1410 emulator the EMULATOR macro instruction must specify URCHAN=1 and 
OVERLAP=YES, in addition to the selected parameters. 

SOFTWARE REQUIREMENTS 

The following instructions will generate a minimum size emulator to execute the 
verification procedures: 

EMULATOR CPU=XXXX, f CORE=40,CHAN=1„URCHAN=1 , OVERLAP=YES,MODEL=14 5 

EMSUP EMNAME=EMSPL10,CCRDR=SYSRDR, X 

TPSUP=CRIGINAL 
EMRDR TODEV=2540 
EMPNCH TODEV=2540 
EMPTR TODEV=1403 
EMTAPE DEVADDR=SYS001,UNIT=11, X 

TYPEFLE=OUTPUT,RECFM=ORIGINAL, BLKSIZE=80 
EMCNSL 
EMEND 

END 

Notes : 

1. xxxx in the EMULATOR macro can be either 1410 or 7010. 

2. Do not specify OVERLAP=YES if CPU=7010 is specified. 

The logical names of the System/370 devices assigned as 1400 reader,, punch, and printer 
are by default SYSIPT,, SYSPCH and SYSLST. If you specified logical names in the form 
DEVADDR=SYSnnn„ be sure that these devices relate to the same devices as SYSIPT, SYSPCH, 
and SYSLST. 

HARDWARE REQUIREMENTS 

A Central Processing Unit equipped with: 

• The IBM Compatibility Feature 4458 for Models 145 

• Standard instruction set 

• One tape drive, if tape functions are to be verified. 
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STORAGE REQUIREMENTS 

The amount of storage required is dependent on what you specify when generating your 
emulator. The errulator described in the section "Software Requirements" takes up 
approximately 27,500 bytes of storage. 



OPERATING INSTRUCTIONS 

1 . Setup Require ments 

None, if tape functions are not to be verified. Otherwise, mount a scratch tape on 
the tape unit assigned to 1400 unit 1, channel 1. 

2 . Operating Instruc tio ns 
On display of message 

EP022D IVPEME HALT/BRANCH IAR=nnnnn AAR=xxxxx BAR=xxxxx DMOD=l 

• Type in START if nnnnn=06106. 

» Type in ECJ if nnnnn is not 06106. 



E20 - System/370 Model 20 Emulator 



Functions Tested 

The Installation Verification Procedure for the System/360 Model 20 emulator tests the 
following Model 20 functions: 

• CPU instructions. 

• Interrupt capability. 

• CPU data and address checking. 

• Operator communications. 

• I/O operations for each type of device the emulator program supports. 

Note : If the E20 verification procedure makes use of a read/punch device (2 520 or 2560) 
it can be used for only one run. For a following run it is necessary to assemble the 
IVPGEN macro again- 

IVPGEN MACRO OPTIONS 

E20=f NO) Specify if the DOS/VS System/3 60 Model 20 Emulator program generation 
(YESJ is to be verified. 

Required Parameter 

E2 0NAME=xxxx Specify the phase name under which the emulator is cataloged in the core 
image library. Length of the phase name may be from four to seven 
characters - 
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HARDWARE REQUIREMENTS 

• A Central Processing Unit equipped with the IBM Compatibility Feature 7520 for Models 
125 and 135 and a standard instruction set. 

• One physical device for each Model 20 device emulated. 

If the System/360 configuration comprises an MFCM, note that the emulation can either be 
performed on a System/370 MFCM or on the combination of a 3504/3505 and a 3525. The MFCM 
is emulated at DOS/VS level by two physical devices,, therefore, enter two ASSGN commands. 



OPERATING INSTRUCTIONS 

1. Setup Requirements 

The system printer must be provided with a carriage control tape with punches in (at 
least) channels 1, 9, and 12. 

2 . Operating Instruction s 
In response to message 

E201D 01 STOP UL=99,PSW=0100062C,ESTR=OFFF 
type in EOJ to pass control to DOS/VS job control. 
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Example of SYSLOG Out put 



BG // JOB IVPE20 

DATE 11/04/73, CLOCK 23/33/07 
BG * INSTALLATION VERIFICATION PROCEDURE FOR MODEL 20 EMULATOR ON S/370 
BG * YOU MUST ASSIGN EACH LOGICAL UNIT USED IN THE EMULATOR GENERATION TO 
BG * A VALID S/370 PHYSICAL DEVICE 

BG * FOR EXAMPLE M20 2501 CARD READER HAS BEEN GENERATED ON SYS0Q4 
BG * YOU MUST ENTER THE FOLLOWING DOS COMMAND 
BG * // ASSGN SYSQ04,X'00C I 

BG * ASSUMING THAT 00C IS A VALID CARD READER TYPE FOR EMULATION 
BG * YOU MUST DO THAT FOR M20 2501 2520/2560 1442 1403/2203 AND TAPES 
BG // PAUSE PLEASE ENTER YOUR ASSGN COMMANDS NOW 
BG // ASSGN SYS004,X'00C' 
BG // ASSGN SYS010,X , 080» 
BG // ASSGN SYS01 1 ,X'081 ' 
BG 

BG // PAUSE IT IS YOUR LAST CHANGE FOR ENTERING ASSGN COMMANDS 
BG 

BG // EXEC EMUL3 

BG E220D ENTER 'DI ON 1 COMMAND FOR DEVICE INDEPENDENCE, IF NOT 'DI OFF* 
BG DI OFF 

BG E201D 01 STOP UL=99,PSW=000001F8,ESTR=0000 
BG S 

BG E201D 01 STOP UL=99,PSW=1000047E,ESTR=0001 
BG CF.S 

BG TAPES 081=SYS011 080=SYS010 
BG DISKS 002=AAAAAA 002=BBBBBB 

BG UR 2501=SYS004 1442=SYSPCH 1403/2203=SYSLST 

BG E201D 01 STOP UL=99,PSW=1 0000482, ESTR=0386 
BG S 

BG E201D 01 STOP UL=99,PSW:010004A6,ESTR=2501 
BG S 

BG E201D 01 STOP UL=99,PSW=010004EE,ESTR=1442 
BG S 

BG E201D 01 STOP UL=99,PSW=0100050E,ESTR=1403 
BG S 

BG E201D 01 STOP UL=99,PSW=0100051E,ESTR=0070 
BG S 

BG E201D 01 STOP UL=99,PSW=31 000542, ESTR=0002 
BG S 

BG E202D MOD20 PROGRAMMING ERROR UL=FA, I=07,PSW=010005F2 
BG CS SD=X'5F2' 

BG 5F2 FA440B820B82488006204A80068C4B80 
BG CS SD=X'B82 ( 

BG B82 00000000000000000000000000000000 
BG CS SA=(X , B82 , / X , 000000001C , ).S 

BG E202D MOD20 PROGRAMMING ERROR UL=4A, 1=08, PSW=1 100061 2 
BG HELP 

BG E2121 CONSULT ! UL» AND 'PSW» WHICH SPECIFY ERROR TYPE AND ADDRESS - 
BG E2121 - OF INSTRUCTION IN ERROR 

BG E2121 USE 'CS 1 COMMAND, FOLLOWED BY »S» TO CORRECT THE ERROR 
BG E2121 IF THE ERROR PERSISTS, ENTER »DF ED,TD,EDJ' TO CANCEL EMULATOR RUN 
BG CS RA=C8,X'0' ).S 

BG E202D MOD20 PROGRAMMING ERROR UL=1A, I=08,PSW=1 100061A 
BG CS RA=C8,X' 0»).S 

BG E201D 01 STOP UL=99,PSW=01000628,ESTR=0003 
BG S 

BG E201D 01 STOP UL=99,PSW=0100062C,ESTR=OFFF 
BG S 

BG E201D 01 STOP UL=99,PSW=0100062C,ESTR=OFFF 
BG EOJ 

BG * IVPE20 IS FINISHED 
BG EOJ IVPE20 

DATE 11/0^/73, CLOCK 23 , 40 , 08, DURATION OO'07'OO 
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Exam ple of SYSLST Out put 



// JOB IVPF20 DATfc 11 /04/73»CL0CK 23/33/07 

* INSTALLATICN VErtlFICAFlCN PRCCbCORE FCR *CDEL 2'J EMULATOR CN S/370 

* YOU WUST ASSIGN EAO LOGICAL LNIT USED Iim ThE EULArCfi GENERATION TO 

* A VALIC S/37C PhYSICAL CEVltE 

* FOR EXAMPLE N2C 2501 CARC HEADER HAS PEEN GLNhKAFE'O Grf SYS004 

* YOU *»L)ST ENTER ThE FOLLOWING CCS CI":"* ANC 

* // ASSGN SYS004,X'CCO 

* ASSUMING TEAT COC IS A VALIC CAKC REACEk TYPE FlR ECULA1ICN 

* YCU fUST DO TFAT FOR *iC 2501 2a2C/25tO 1442 14L3/2203 AND TAPtiS 
// PAUSE PLEASE tM£R YCLR ASSGN CCPfAfsOS .M0» 

// ASSGN SYSCC4,X , CCC' 

// ASSGN SYSOlCX'OaC 

// ASSGN SYSOll.X'Ofil' 

// PAUSE IT IS YCUR LAST CHANCE FLR ENTERING ASSGN LOKWAUDS 

// EXEC ENUL3 

Dl OFF 

EC DC^'Z/LC 

LD 



SAMPLE OUTPUT CATA 
SAHPLE OUTPUT CATA 



SAMPLE OUTPUT CATA 
NCW SKIP TO CHANNEL I 



THE 18 FIRST CHARACTERS OF THIS LIKE ARE THE 
SAME AS THOSE OF THE PREVIOUS LINE 



NOW SKIP TC CHANNEL 12 
NOW SKIP 1C CHANNEL 09 

YOU HAVE GENERATEC THE FOLLOWING MODEL 20 CONFIGURATION 

2S01 CARD READER 

1442 CARD PUNCH 

1403/2203 PRINTER 
YOUR TAPE UMI ADDRESSES ARE = 60 81 
YOU HAVE GENERATED STORAGE CONTRCL FEATURE 



* IVPE20 IS FINISHED 
EOJ IVPE20 



DATE 11 /(M/73tCLCCK 23/4C7C8, DURATION 00/07/00 
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OLT - OLTEP 



Function Tested 

• The possibility of initializing online testing. 

OPERATING INSTRUCTIONS 
Action Messages 

01E105D ENTER-DEV/TEST/OPT/ 
Reply by typing in 

R 01, 'CANCEL' 
to terminate the execution of the OLTEP verification procedure. 

PWR - POWER/VS 

Function Tested 

The test checks that the generated version of POWER/VS functions in accordance with the 
specifications. 

SOFTWARE REQUIREMENTS 

POWER=YES must have been specified as a SUPVR macro parameter when assembling tne 
supervisor. POWER/VS must be running while the test is being performed. 

Make sure that only POWER/VS jobs are in the input stream. When a reader task is 
started, all reader input is read in and put into the POWER/VS files. 

UTL - System Utilities 

Functions Tested 

Standard 

CLRDK Clear Disk 

CDKCD Copy disk to card 

CDKDK Copy disk to disk 

RCDDK Restore card to disk 

LVTOC VTOC display 

Note: If the PCHADDR parameter is not specified, CDKCD and RCDDK will not be verified. 
For cardless systems, PCHADDR must be omitted. 
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Optional 

• If UTLT=YES is specified in the IVPGEN macro: 

INTTP Initialize tape 
CDKTP Copy disk to tape 
RTPDK Restore tape to disk 

• If UTLZ=YES is specified in the IVPGEN macro: 

CLRDC Clear data cell 

CDKTP Copy data cell to tape (only if UTLT=YES is specified) 

RTPDK Restore tape to data cell 

HARDWARE REQUIREMENTS 

Required: 2 direct-access devices 
1 printer. 

Optional: 1 tape drive 

1 data cell drive 

1 card reader 

1 card punch 

1 diskette I/O unit. 
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Module 4: 1401/1440/1460 DOS/VS Emulator on 
System/370 - 5747- CC3 
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The 1401/1440/1460 Emulator Program for the IBH System/370, available as separate 
programming package, consists of a group of aacro instructions and object and load 
modules that are shipped in source statement, relocatable, and core image libraries. 
Two sample programs that test the uorking of a 1401/1460 program, of a 1440 program, 
and of a 1401G program under the emulator are contained in the source statement library 
under the name Z.EMSPL01. The source cards of this program are cataloged under the narae 
2.EHSPL01S. 

For detailed installation procedures, refer to 1401/1440/1460 DOS/VS Emulator on 
System/370 Bef ere ace, GC 33- 5 3 84. 
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I Module 5: 1410/7010 DOS/VS Emulator on System/370 -- 5747-CC3 
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The 1410/7010 Emulator Program, available as separate programming package, consists of a 
group of macro instructions and object and load modules that are shipped in source 
statement, relocatable, and core image libraries, ft sample program that tests the 
working of a 14 10 and 7010 program under the emulator is contained in the source 
statement library under the name Z.EM5PL10. The source cards of this program are 
cataloged under the name Z. EMSPL10S. 

For detailed installation procedures, refer to 1 410 /7010 D OS /VS Emulator on Sy.stem/370 
fief§£ence, GC33-5385. 
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Module 6: Emulating the /360 Model 20 on Models 115, 125, 135, 
and 138-5745-SC4E20 
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MODEL 20 EMULATOR UNDER DOS/VS 



RELOCATABLE LIBRARY 



The Model 20 Emulator Program consists of a 
group of macro instructions and object and 
load modules that are shipped in the source 
statement, relocatable, and core image 
libraries. An installation verification 
program for postgeneration use is contained 
in the source statement library under the 
name Z.IISIVP20. In addition to the 
emulator, a data interchange function is 
supplied with the generation macro E.EMUDI. 



P ARTITION SIZE 

For further information, refer to the Model 
20 emulator publication. 



SOURCE STATEMENT LIBRARY 

r t 1 

| Number of | Number of | 
j Macros | Library Blocks | 
I j (Physical Records) | 
^ + j 

1 22 | 2,284 | 

L X J 

Macros 

E.EM1403 

E.EM1442 

E.EM2 0CHK 

E.EM20CONV 

E.EM2 0CPU 

E.EM20DI 

E.EM20END 

E.EM20MESS 

E.EM20PRHD 

E.EM20SYS 

E.EM20VRIF 

E.EM2152 

E.EM2203 

E.EM2311 

E.EM2400 

E.EM2501 

E.EM2520 

E.EM2560 

E.IISCR 

E.IISDC 

E.IISEDB 

E.IVPE20C 

Delete Statements 

DELETS E.EM1403 
DELETS E. EMI 442 
DELETS E.EM20CHK 



r t 1 

| Number of j Number of Library Blocks | 
j Modules j (Physical Records) | 
f + ., 

| 28 | 206 | 

i j j 

Module Name Bytes of Storage 



I IS CM 


1165 


IISCMS 


1117 


IISCP 


936 


IISCPS 


254 


USEE 


928 


IISDD 


1168 


IISDE 


340 


IISDF 


3328 


IISDFED 


1771 


IISDI 


1334 


IISDK 


3072 


IISDI 


342 


IISD2 


466 


IISD3 


470 


IISE4 


622 


USED 


5896 


IISHC 


424 


IISHF1 


2804 


IISHF2 


3204 


IISIE 


284 


IISIN 


1304 


IISMD2 


1487 


IISMF 


1060 


IISPD2 


348 


IISTD 


752 


IISTP 


1848 


IISTPH 


1161 


IISTR 


432 



Link-Edit Statements 

The ACTION CLEAR, PHASE, and INCLUDE 
statements are generated automatically, in 
accordance with your specifications, when 
the E.EM20END macro is assembled. For more 
detailed information on the link-edit 
statements, refer to the Model 20 emulator 
publication. 

Del ete Stat ements 

IIS is the identifier for both the basic 
Model 20 Emulator and the associated data 
interchange function. The statement 
DELETR IIS. ALL causes both the emulator and 
its data interchange function to be 
deleted. Unless this is desired, delete 
the modules one by one: 

DELETR IISCM 
DELETR IISCMS 



DELETS E.IISEDB 



DELETR IISTR 
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CORE IMAGE LIBRARY 



Macro 



r t 1 

| Number of | Number of | 
| Transients j Library Blocks | 
I ] (Physical Records) | 
y + ., 

| 19 | 32 | 

L X J 



E.EMUDI 



Delete Statement 



DELETS E.EMUDI 



Transients 

$$BIISAL 
$$BIISAS 
$$BIISA2 
$$BIISCC 
$$BIISCD 
$$BIISCF 
$$BIISCS 
$$BIISDI 
$$BIISDP 
$$BIISLE 
$$BIISM1 
$$BIISM2 
$$BIISM3 
$$BIISM4 
$$BIISPR 
$$BIISRL 
$$BIISTD 
$$BIISTS 
$$BIISUR 



Delete Statements 

DELETC $$BIISAL 
DELETC $$BIISAS 



DELETC $$BIISUR 



DATA INTERCHANGE FUNCTION 



The Model 20 Data Interchange Function is 
generated as part of the Model 20 Emulator, 
under macro E.EMUDI. 



PARTITION SIZE 

For further inf ormation,, refer to the Model 
20 emulator publication. 



S OURCE STATEMENT LIBRARY 

r t 1 

| Number of | Number of | 

J Macros | Library Blocks | 
| I (Physical Records) j 

Y + -} 

| 1 | 187 | 

L J. J 



RELOCATABLE LIBRAR Y 

r t 1 

| Number cf | Number of Library Blocks | 
j Modules | (Physical Records) j 
f f j 

| 45 | 300 | 

L X J 



Module s 

IISCA 

IISDA 

USDS 

IISEQ 

IISF1 

IISF2 

IISF3 

IISF4 

IISIB 

IISIF 

IISIL1 

IISIL2 

IISIL3 

IISIL4 

IISIRl 

IISIR2 

IISIR3 

IISIR4 

IISMB 

IISMI 

IISML 

IISMO 

IISMR 

IISMS 

IISMSG 

IISSC 

IISSCI 

IISSCV 

IISSQ 

IISS1 

IISS2 

IISS3 

IISS4 

IISTK 

IISTKC 

IISTKE 

IISTKI 

IIST1 

IIST2 

IIST3 

IIST4 

IISV1 

IISV2 

IISV3 

IISVU 
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Link-Edit Statements 



Transients 



The link-edit statements are generated 
automatically, in accordance with your 
specifications, when the E.EMUDI macro is 
assembled. For more detailed information, 
refer to the Model 20 emulator publication. 

Delete Statements 



$$BIISUC 
$$BIISUM 
$$BIISBI 
$$BIISBS 
$$BIISEX 
$$BIISFM 



IIS is the module identifier for both the Phases 
Model 2 Emulator and the associated data 

interchange function. The statement IISMTA 

DELETR IIS. ALL causes both the emulator and IISMTE 

the data interchange function to be IISMTC 

deleted. Data interchange modules must IISMTD 

therefore be deleted individually: IISMTE 

IISMTE 

DELETR IISCA IISMTG 
DELETR IISDA 



Delete Statements 



DELETR IISV4 



DELETC $$BIISUC 
DELETC $$BIISUM 



CORE IMAGE LIBRARY 



r r 1 

| | Number of | 
] I Library Blocks | 
j J (Physical Records) j 
Y T + j 

| Transients | 6 | 8 | 

(. + + -| 

| Phases | 7 j 7 | 

L X -L J 



EELETC $$BIISFM 



DELETC IISMTA 
DELETC IISMTB 



DELETC IISMTG 
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r t n 

1 # TRANSIENTS | CIL BLOCKS j 
J. 1 ., 

| 20 | 22 j 

L JL J 

CORE IMAGE LIBRARY 



T ransients 

$$BCBLIS \ 

$$BCBLOP / 

$$BCBODA J> 

$$BCBUSR \ 

$$BCBUSW / 

$$BCOBER 

$$BCOBRl 

$$BFCMUL 

$$BPLOSE 

$IJKS00 

$IJKS10 

$IJKS20 

$IJKS30 

$IJKS40 

$IJKS50 

$IJKS60 

$IJKS70 

$$BMU100 

$$BMU2 00 

$$BMU300 



COBCL D 



ANS/COBOL 



PL/I 



MPS Utilities 



Module 7 lists the names of the preassembled modules shipped by IBM in the relocatable 
library, their external storage requirements in library blocks, and the compilers that 
create linkage for their use. The size of these modules, if this should be needed to 
determine virtual storage requirements, may be calculated based on the module names 
(which give an indication of the specified parameters) and the values given under 
"Component Requirements - IOCS Routines" in Module 1 of this manual. 

No IOCS modules are required for FORTRAN. 

An x in a column headed by a compiler indicates that the particular module may be 
linked by that compiler to the problem program. For example, an x in the columns headed 
by COBOL and PL/I indicates that COBOL and PL/I link the module so identified. For 
assembler language programs, the user can preassemble IOCS modules as described in DOS^VS 
Supervisor and 1^0 Macros. Note that separate modules are not assembled for DTFCN or 
DTFSR. 



The preassembled modules named in this module can be used by any other problem program 
whenever applicable. 

r r r n 



American National Standard COBOL 
American National Standard COBOL and COBOL 
American National Standard COBOL and PL/I 
American National Standard COBOL,, COBOL and PL/I 
COBOL 

COBOL and PL/I 
PL/ 1 

PL/I Optimizing Compiler 
RPG II 

Required IOCS Modules 
l ; j. -L 

Note : Certain preassembled IOCS modules are required when cataloging IBM components to 
the core image library. Do not delete these modules from the relocatable library until 
after all the IBM components you desire have been cataloged to the core image library. 
The modules are found in "Required IOCS Modules". 



1 Modules 


Blocks | 


| 223 


1247 | 


| 148 


991 | 


| 163 


1100 | 


| 169 


1181 | 


| 341 


1272 | 


| 77 


578 | 


| 107 


698 | 


| 70 


412 | 


I 161 


876 | 


| 32 


108 | 
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Relocatable Module Naming Conventions 

Each module name begins with a 3-character prefix and consists of a 5-character field 
corresponding to the option permitted in generation of the module. The following 
3-character prefixes identify the preassembled IOCS modules shipped by IBM: 

IJC I/O Card (CCMOD) and 3881 Optical Mark Reader 

IJD I/O Printer (PRMOD) 

IJF I/O Magnetic Tape (MTMOD) 

IJG Sequential Direct Access (SDMOD) 

IJH Index Sequential Direct Access (ISMOD) 

IJI Direct Access Method (DAKOD) 

IJJ Device Independent Access Method (DIMOD) 

UN I/O Diskette (DUMOD) 

CDMOD 

CDMOD name = IJCabcde 

a = F RECFORM=FIXUNB (always for INPUT and CMEND files) 
= U RECFORM=UNDEF 
= V RECFORM=VARUNB 

b = A CTLCHR=ASA (not specified CMBND) 

= C CONTR0I=YES 

= Y CTLCHR=YES 

= Z neither CTLCHR nor CONTROL is specified 

C = B RDONLY=YES and TYPEFLE=CMBND 

= C TYPEFLE=CMBND 

= H RDONLY=YES and TYPEFIE=INFUT 

= I TYPEFLE=INPUT 

= N RDONLY=YES and TYPEFLE=CUTPUT 

= O TYPEFLE=OUTPUT 

d = B WORKA=YES and I0AREA2=YES 
= I I0AREA2=YES 
= W WORK A = YES 
= Z neither WCRKA nor I0AREA2 is specified 

(for CMBND files: WORKA is no t specified) 

e = DEVICE=25U0 or DEVICE=3881 

= 1 DEVICE=1442 or DEVICE=2596 

= 2 DEVICE=2520 

= 3 DEVICE=2501 

= 4 DEVICE=2540 and CRDERR is specified 

= 5 DEVICE=2520 and CRDERR is specified 

= 6 DEVICE=3505 

= 7 DEVICE=3525 and FUNC omitted, FUNC=R or FUNC=P 

= 8 DEVICE=2560 and FUNC omitted, FUNC=R or FUNC=P 

= 9 DEVICE=5425 and FUNC omitted, FUNC=R or FUNC=P 

= A DEVICE=3525 and FUNC=RP 

= B DEVICE=3525 and FUNC=RW 

= C DEVICE=3525 and FUNC=PW 

= D DEVICE=3525 and FUNC=I 

= E DEVICE=3525 and FUNC=RPW 

= F DEVICE=2560 and FUNC=RP 

= G DEVICE=2560 and FUNC=RW 

= H DEVICE=2 5 60 and FUNC=PW 

= I DEVICE-2560 and FUNC=I 

= J DEVICE=2560 and FUNC=RPW 

= K DEVICE=5U25 and FUNC=RP 

= L DEVICE=5425 and FUNC=RW 

= M DEVICE=5425 and FUNC=PW 

= N DEVICE=5425 and FUNC=I 

= DEVICE=5425 and FUNC=RPW 

180 DOS/VS System Generation 



r 

j CDMOD 
| Names 


~T T 
1 1 
I 1 
|COEOL|PL/I 
i i 


T T T " 
1 1 VL/1 j 

j | Optimizing j American 
|RPGII| Compiler | Standard 
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COBOL 1 


| IJCFAOID 
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X 
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_ 1 
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T 
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| IJCFAOZE 
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IUCFAOZ0 














j IJCFAOZ1 


X 


X 




X 


X 




JIJCFAOZ2 
| IJCFAOZ4 


X 


X 
X 




X 


X 




| IJCFAOZ5 
| IJCFAOZ7 


X 
X 






X 
X 


X 




|IJCFAOZ8 


X 






X 






| IJCFAOZ9 










X. 






|IJCFCCZ0 
J IJCFCCZ1 






X 
X 








|IJCFCCZ2 


T 

1 

-+- 

1 

1 




T 
-+- 

-+" 




T 
_A_ 

_A_ 

A 


X 


T 
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-+- 
A 




T 
1 

1 
__A 

I 

_ A 






| IJCFCIWB 
j I JCFCIWG 






X 
X 








| IJCFCIWL 
IIJCFCIZO 
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— L 
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T 
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A 


X 
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_ A 






| IJCFCIZ1 
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1 
-f- 

1 
-+- 
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T 
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-+" 
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X 
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X 




J 
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r T T T T T 

I I I I I PL/I I 

| CDMOD | j | | Opt i mi zing | American National 
|Names |COEOL|PL/I |RPGII| Compiler | Standard COBOL 
h 4 4 4 4 4 

|IJCFCIZ7 | | | x | | 

[. 4 4 + + + 

|IJCFCIZ8 | | | X | | 

|. + + 4 4 4 

|IJCFCIZ9 | | | x j | 

Y 4 4 4 4 4 

JIJCFCOI1 j | | X | | 

J. + + 4 4 + 

I ijcfcoiu I I I x | I 

h 4 4 4 + + 

|IJCFC0I5 | | | X | | 

j. + 4 4 4 + 

| IJCFCOWA | | I X | | 

h f + 4 4 + 

| I JCFCOWC | | | X | | 

|. 4 4 4 4 4 

| IJCFCOWE | | | X | ] 

h 4 4 4 4 4 

JIJCFCOWF | | | x | | 

h 4 4 4 4 4 

| IJCFCOWH | | | X | | 

y 4 4 4 4 4 

| Io "FCOWJ | | | X | | 

|. 4 4 4 4 4 

| IJCFCOWK | | | X | | 

h 4 4 4 4 4 

|IJCFCOWM | | | X | | 

y 4 4 4 4 4 

| IJCFCOWO | | | X | | 

|. 4 4 4 4 4 

|IJCFCOZl j | | X | | 

h 4 4 4 4 4 

|IJCFCOZ4 | | | X | | 

|IJCFCOZ5 | j | X | | 

P 4 4 4 4 4 

IJCFCOZ7 | | | x | | 

^ 4 4 4 4 4 

|IJCFCOZ8 | | | X | | 

h + + + + + 

IJCFCOZ9 | | | X | | 

IUCFYOID I | | | X | 

4 4 4 4 4 

IJCFYOIO | X | | | | 

,. 4 4 4 4 4 

IIJCFYOIl J | x | x | x | 

4 4 4 4 4 

IJCFYOI2 | 1 x j j | 

h 4 4 4 4 4 

JIJCFY0I4 1 | x | x ] x | 

r 4 4 4 4 4 

IJCFY0I5 | j j x | x | 

r 4 4 4 4 4 

:IJCFY0I7 | X | j | x | 

4 4 4 4 4 

IJCFYOI8 | | | j x | 
IJCFYOI9 | | | | x | 

4 4 4 4 4 

IJCFYOZA I I I I x I 
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CDMOD 
Names 



]CCEOL 

-+ 

I 

f 



PL/ 1 



jRPGII 
+ 



PL/ 1 
Optimizing 
Compiler 



American National 
Standard COBOL 



IJCFYOZC 
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I 
+— - 



IJCFYOZD 
IJCFYOZE 
IJCFYOZO 
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IJCFZIIO 



•+— - 
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f— - 
i 
■+" 
I 

■+— " 
I 

+— - 
i 

f— - 
! x 
























x 

X 

+ 



+— - 
I 

4 

X 



i x i 

X 

X 
X 
X 



IJCFZII1 
IJCFZII2 



! x 

4— - 

I x 



X 

+ — 

X 






IJCFZII3 



I x 

■+— - 

I x 

■+— - 



I x 

+ — 

I x 

+ — 

X 



IJCFZII6 
IJCFZII7 









IJCFZII8 
IJCFZII9 
IJCFZIWA 



i X 
.+— - 






I 

+ 



+ 

I 

+ 
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I X 

-+ 

x 

■+— ' 
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+-- -- 
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+- — 

I x 

-+ — 

I x 

1 x 
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I x 



— + 






-+- 
I 
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r r t t t t n 

I III! PL/I | | 

| CDMOD J J | | Optimizing | American National) 
| Names JCOEOLJPL/I JRPGIIj Compiler | Standard COBOL | 

IIJCFZIZO ) x | x | x | x | x | 

h 4 4 + + 4 -| 

[IJCFZIZl J x ] x | x J x ] x | 

(. , + + + 4 4 j 

|IJCFZIZ2 | x | x J x ] x | x | 

h 4 4 + + + -I 

|IJCFZIZ3 \ x | x ] x | x ] x | 

|. + + + 4 + -I 

[IJCFZIZ6 | X | | x | x | | 

(IJCFZIZ7 | X | | x I x | | 

h 4 4 + 4 4 ., 

|IJCFZIZ8 j X | | x | x | | 

JIJCFZIZ9 j j | x | x | | 

j. + + 4 4 4 ) 

I IJCFZOID ] X | | j x | | 

IIJCFZOI1 | x | x | 1 x ] x | 

h + + 4 + + 4 

|IJCFZOI2 | | x | | | | 

h 4 4 4 + + i 

JIJCFZOIU | x | x | x | x j x | 

|. 4 + + 4 + j 

|IJCFZOI5 | x | | | x | x 1 

y 4 4 + + + 4 

|IJCFZOI7 | X | | x | x ] | 

|IJCFZOI8 | X J | x | x | | 

j. 4 4 + + + .| 

|IJCFZOI9 | | | x | x | | 

| IJCFZOWA | | | x | | | 

j. 4 + 4 + + 4 

[IJCFZOWC I | | x | | j 

| IJCFZOWE | | | x | | | 

Y 4 4 4 + + j 

JIJCFZOWF | | | X | | | 

IIJCFZOWH | | | X | | | 

j. 4 4 4 + + 4 

|IJCFZOWJ | j | X j 1 | 

r + + 4 + + j 

| IJCFZOWK | | | x | | | 

|IJCFZOWM | | | x | 1 | 

I JCFZOWO J j | | x | | | 

h 4 4 + 4 + 4 

jIJCFZOZA | X j j | x j | 

IJCFZOZC | X | | | x | | 

IIJCFZOZD | X | | | x | | 

+ + + + 4 ^ 

IJCFZOZE | X j | j x | j 

h 4 4 4 4 4 ^ 

[IJCFZOZ1 | x j x j I x | x j 

4 4 4 4 4 ^ 

IJCFZOZ2 ! I x I I I I 
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r t 




~T T 




T 

j PL/ 1 


T 1 


] CDMOD | 








| Cptimizing 1 American National! 


| Names |COEOL|PL/I |RPGIIJ Compiler 

L i i l I 


| Standard COBOL | 
1 x 1 
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r T 
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r t 
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T T 
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T 1 
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1 x 
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- + 4 
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1 x 
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1 x 


_ + 4, 
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r T T T T T 1 

! I I I I pl/i I I 

I CDMOD j J J | Optimizing j American National! 
|Names |COEOL|PL/I |RPGII| Compiler | Standard COBOL j 

|IJCUYOZ5 | | | | x | | 

h 4 + 4 + + ., 

|IJCUYOZ7 j | | | x ] | 

h + + + 4 4 j 

JIJCUYOZ8 | | I | x I | 

y 4 4 + 4 + -j 

|IJCUYOZ9 ] | | | x | | 

|IJCUZOIl | X | | | x | x | 

h 4 4 + + + 4 

|IJCUZOI4 } x | | | x | x | 

|. 4 + + 4 4 j 

|IJCUZOI5 | X | | | x | x | 

h ___ 4 4 + 4 + ^ 

|IJCUZ0I7 J X j i i x I I 

|IJCUZOI8 | X | | | x | | 

|IJCUZ0I9 | | | | x | | 

h + + 4 4 + j 

(IJCUZOZA | j 1 | x | | 

y 4 + + + + ., 

|IJCUZOZC I j j I x i I 

IJCUZOZE 1 I I I X I I 

[ 4 4 4 + + -J 

|IJCUZOZl I X [ I I X I X I 

+ 4 4 4 + 4 

IJCUZOZ4 I X j I j x I x I 

[ 4 + + + + 4 

IJCUZOZ5 I X I I I x I x | 
+ + + + + -f 

IJCUZOZ7 | X | | | x | j 

t + + + + + 4 

IJCUZOZ8 | X | | | x | j 

4 4 4 4 4 .j 

IJCUZOZ9 | j | | x | I 

4 4 4 4 4 4 

IJCVAOIl | X | | | x | X | 

4 4 4 4 4 4 

IJCVAOI4 | X | | | x | x | 

IJCVAOI5 | X | I I X | x | 

4 4 4 4 4 4 

IJCVAOI7 | | | | X | j 

. 4 4 4 4 4 4 

IJCVAOI8 | X | | | x | | 

4 4 4 4 4 ^ 

IJCVAOI9 1 | | | x | | 

4 4 4 4 4 j 

IJCVAOZA | | | | X | | 

4 4 4 4 4 ^ 

IJCVAOZC | | | | x | | 

4 4 4 4 4 -I 

IJCVAOZE | | | | X | | 

4 4 4 4 4 _ ^ 

IJCVAOZl | X | I | x | x | 

4 4 4 4 4 4 

IJCVAOZU j X | | | x | X | 

4 4 4 4 4 ^ 

IJCVAOZ5 I X I I I x I x I 



186 DOS/VS System Generation 



r T ^T T T T 

I 1 I I I PL/I I 

| CDMOD | J | | Optimizing | American National 
j Names |CCEOL|PL/I |RPGII| Compiler | Standard COBOL 
h 4 + 4 4 + 

|IJCVAOZ7 | | | | x | 

h 4 4 4 4 + _^__ 

|IJCVA0Z8 | X | | | x | 

h 4 + 4 + + 

|IJCVA0Z9 | | | | x | 

| IJCVYOI1 | | | 1 X | 

h 4 + + + + 

|IJCVYOI4 j | | | x | 

|. 4 + + 4 4 

|IJCVYOI5 | j | j X | 

[ 4 + + + + 

|IJCVYOI7 ] | | | x ] 
JIJCVYOI8 | | | | x | 

h 4 + + + + 

|IJCVYOI9 1 | | | x | 

r 4 4 4 4 4 

| IJCVYOZA | | | | X I 

[ 4 4 4 4 4 

IIJCVYOZC | | | | X j 

. 4 4 4 4 4 

I IJCVYOZE j | I j x j 

y 4 4 4 4 4 

|IJCVYOZl ] j j j X J 

r 4 4 4 4 4 

IJCVYOZ4 | | | | x | 

h 4 4 4 4 4 

|IJCVYOZ5 | | | | x | 
IJCVYOZ7 | j | | x | 

Y 4 4 4 4 4 

JIJCVYOZ8 | j j | x | 

4 4 4 4 4 

IJCVYOZ9 | j j j x | 

r 4 4 4 4 4 

IJCVZOIl I x I I I x I x 

4 4 4 4 4 

IJCVZOIU I X I j I x I x 

4 4 4 4 4 

IJCVZOI5 | X j I I X I x 

4 4 4 4 4 

IJCVZOI7 | X | j I x | 

4 4 4 4 4 

IJCVZOI8 | x | I I x | 

4 4 4 4 4 

IJCVZOI9 | j j | x | 
IJCVZOZA | | | | X | 

4 4 4 4 4 

IJCVZOZC I i I I x I 

IJCVZOZE | | | | X | 
L ± J. A A 
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r T T T T T 1 

I I I I I PL/I J | 

| CDMOD | | | | Optimizing | American National) 
j Names | COEOL |PL/I ]RPGII| Compiler | Standard COBOL | 
h + + + + + ^ 

| IJCVZOZ1 I X I I I x I x | 

[IJCVZOZ4 | X | | | X | X | 

|. + + + + + J 

| IJCVZOZ5 | X | | j x | x | 

y + + + + + 4 

|IJCVZ0Z7 | X | | | x j i 

j. + + + 1 + -f 

|IJCVZOZ8 | X | | | X | | 

h + X + + + .} 

JIJCVZ0Z9 | | | | X | | 

L L X X X -L i 
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DAMOD 



DAMOD name = IJIabcde 



a 


= 


B 




= 


F 




= 


S 




= 


V 


b 


_ 


A 




= 


W 




= 


z 


c 


= 


E 




= 


I 




= 


R 




= 


Z 


a 


= 


H 




= 


P 




= 


R 




= 


Z 


e 


= 


W 




= 


X 




= 


Y 




= 


Z 



RECFORM=UNDEF (handles both UNDEF and FIXUNB) 

RECFORM=FIXUNB 

RECFORM=SPNUNB 

RECFCRM=VARUNE 



AFTER=YES 

RPS version of module 

AFTER is not specified 

IDLOC=YES and FEOVD=YES 

IDLOC=YES 

FEOVD=YES 

neither is specified 

ERREXT=YES and RELTRK=YES 

ERREXT=YES 

RELTRK=YES 

neither is specified 

HOLD=YES and RDONLY=YES 

HOLD=YES 

RDONLY=YES 

neither is specified 



r 


_ T 




T 




T 




T 


FL/I 


T 


i 


| DAMOD 














(Optiinizi 


ng| American National | 


| Names 


| COBOL] PL/I 


|RPGII| 


Compile 


r |Standa 


rd COEOL | 




__L 




J_ 




j. 




j. 




_L 






T 




T 




T 




T 




T 




| IJIEAIRZ 


-4- 


X 


-4- 




-4- 




-4- 




—4 


x j 


| IJIBAIZZ 


-4- 


X 


-4- 




-4- 




-4- 




—4 


x j 


IIJIEAZHZ 


-+- 




-4- 




-4- 




-4- 


X 


-j 




| IJIBAZRZ 


X 








X j 




_ 1 




j. 




j.— 




j 




_L 






T 




T 




T 




T 




T 




IIJIBAZZZ 


_X 


X 


_L 




J. 




J__ 




J. 


X | 




T 




T 




T 




T 




T 




| IJIBWEHW 


"4" 




-4- 




-4- 




-4- 




—4 




JIJIBZIRZ 


_J_ 


X 


x 




i 




j. 




j_ 


X | 




T 




T 




T 




T 




T 




|IJIBZIZZ 


-J- 


X 


1 




J. 




i. 




J. 


X | 




T 




T 




T 




T 




T 




|IJIBZZHZ 


"+- 




-4- 




-4- 




-4- 


X 


—4 




IIJIBZZRZ 


"4" 


X 


-4- 




-4- 




-4- 




—4 


X | 


IIJIBZZZZ 


-JL 


X 


• 




j. 


X 


j 




L 


X | 




T 




T 




T 




T 




(- 




| IJIFAIRZ 


-+- 


X 


-4- 

-4- 




-4- 
-4- 




-4- 

-4- 




_+ 


X | 


| IJIFAIZZ 


X 








X j 


| IJIFAZHZ 








X 






-f- 




-4- 




-4- 




-4- 




~4 




|IJIFAZRZ 


.j. 


X 


j. 




j._ 




_x 




x. 


X j 




T 




T 




T 




T 




^. — 




| IJIFAZZZ 




X 




X 












X | 
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r t r r r r 1 

I till PL/I I I 

j DAMOD | j J j Optimizing | American National j 
| Names | COBOL | PL/I |RPGII| Compiler | Standard COBOL | 

j IJIFWEHW 1 | | | I | 

y + 4 4 4 4 ^ 

IIJIFZIRZ | X | | | | x | 

|. 4 4 4 + 4 ^ 

jIJIFZIZZ | x | ] j | x | 

y + 4 4 4 4 j 

| IJIFZZHZ | | I | X | j 

Y 4 4 4 + + 4 

JIJIFZZRZ | X I | j ! x | 

jlJIFZZZZ | x j x j x | | x | 

h r + + + + 4 

|IJISAIRZ | X | | | | x | 

IIJISAIZZ | X | | | | x | 

|IJISAZRZ ] X | | | J x j 

j. + + f + + ^ 

IIJISAZZZ | X | | | | x | 

(. + + + + 1 ^ 

IIJISWEHW | | | | | | 

y + 4 4 4 4 j 

IIJISZIRZ | X | | | | X | 

|. 4 4 4 4 4 4 

IIJISZIZZ j X I I I j x I 

IIJISZZRZ I X I I I j x | 

IIJISZZZZ I X I I I I x | 

I IJIVWEHW I I I I I I 



L J J. J. X. -L J 
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DIMOD 

DIMOD name = IJJabcde 

Note ; See "Required IOCS Modules" before deleting modules with the IJJ prefix, 

a - F RECFORM=FIXUNB 

b = C non-RPS version of module 

= V RPS data set 

c * B TYPEFLE=OUTPUT (processes both input and output) 

= I TYPEFLE=INPUT 

d = I IOAREA2=YES 

= Z I0AREA2 is not specified 

e - C RDONLY^YES 

- D RDONLY is not specified 



| DIMOD Names 

I 

JIJJFCBID* 

JIJJFCBZD* 

IIJJFCIID 

| IJJFCIZD 

1 1 JJFVBIC * 

| IJJFVIIC 

t 



-T "' 



PL/I 



BPG II 



PL /I 
Optimizing 
Compiler 



-4 



♦Note: To obtain support for the TRC parameter for the 3800 printer when 
extended printer buffering is not being used, reassemble the modules that 
include B in the module name (that is, those for which TYPEFLE=OUTPUT has been 
specified) . Specify TRC^YES on the DIMOD macro when reassembling. 
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ISMOD 



ISMOD name = IJHabcde 



= A RECFORM=BOTH and IOROUT=ADD or ADDRTR 

= B RECFORM=FIXBLK and IOROUT=ADD or ADDRTR 

= U RECFORN!=FlXUNB and IORCUT=ADD or ADDRTR 

= Z RECFORM is not specified and IOROUT=LOAD or RETRVE 



b = A IOROUT=ADERTR (non-RPS version of module) 

= I IOROUT=ADD 

= L IOROUT=LOAD (non-RPS version of module) 

= R IOROUT=RETRVE 

= V IOROUT=ADDRTR ( RPS version of module) 

= X IOROUT=LOAD (RPS version of module) 

C = B TYPEFLE=RANSEQ 

= G IOAREA2=YES and TYPEFLE=SEQNTL or IOROUT=LOAD 

= R TYPEFLE=RANDOM 

= S TYPEFLE=SEQNTL 

= Z neither is specified and IOROUT=LOAD or ADD 

d = B CORINDX=YES and HOLD=YES 

= C CORINDX=YES 

= O HOLD=YES 

= Z neither specified 

e = F CORDATA=YES„ ERREXT=YES, and RCONLY=YES 

= G CORDATA=YES and ERREXT=YES 

= O CORDATA=YES and RDONLY=YES 

= P CORDATA=YES 

= S ERREXT=YES and RDONLY=YES 

= T ERREXT=YES 

= Y RDONLY=YES 

= Z nothing is specified 



r r t t t t n 

I I I I I PL/I | I 

| ISMOD I ] j | Optimizing | American National j 
| Names |C0EOL|PL/I jRPGII] Compiler ] Standard COBOI | 

|. + x + x x -I 

| IJHAABCP III! | X | 

IIJHAABCZ | | | x | | x | 

| IJHAABZP | | | | | x | 

h + + + + + 4 

JIJHAABZZ | x | | x | J | 

|. + + + + + ^ 

| IJHAARCG | | | | X | | 

|IJHAARCP | x | x | | | x | 

| IJHAARCT | | | | X | | 

y + + + + + .j 

| IJHAARCZ | x | X | x | | x | 

j. + + + + + j 

| IJHAARZG | | | | x | | 

|. + + + + + 4 

JIJHAARZP j x j x j | | x | 

IIJHAARZT | | | | x | | 

y 4. + + + + -I 

IIJHAARZZ I x I x I x I ! x I 



L x J. x x x J 
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r r t t t t -\ 

I 1 I I I PL/I | | 

|ISMOD | J J j Optimizing) American National) 
I Names | COBOL j PL/ I ]RPGII| Compiler | Standard COBOL | 

|IJHAASZZ | x | | | x | | 

j. X + + X X ^ 

|IJHAIZCZ | | | x | J | 

IIJHAIZZZ | x | j x | | | 

y X X + + x + 

JIJHAVBBF j j j j ] | 

h X + + X + ^ 

| IJHAVBBS | | | | | | 

h X + + + X H 

|IJHAVBCF j -] | | | I 

| IJHAVBCS | | | | | I 

(. X X X X x 4 

IIJHAVGBF | | | | | | 

IJHAVGBS | I | | I | 

| IJHAVGCF | | | | | | 

IJHAVGCS | | | | | | 

|IJHEABCP J X | | | j x | 

IJHBABCZ | X | | X | | x | 

^ X X X X X .J 

IIJHEABZP 1 X | | ) | X | 

IJHBABZZ I x | | x | | x | 

r x x + X X j 

IJHEARCP | x | x | | | x | 

IJHBARCZ | x | x | x | I x | 
r X X X X X + 

IJHEARZP ] X | x | | | X I 

IJHBARZZ | x | x | x | | x 

r f + + + + 1 

IJHEASZZ | x | | x | I | 

IJBIZCZ 1 1 | | x | | | 

r x X + x + 4 

IJHBIZZZ J x | j x | | | 

IJHUABCP | X | | | | X | 

r + + + + + -f 

IJHUABCZ | X | | x | | X j 
X + x x x ^ 

IJHUABZP 1 X I | | | x j 

IJHUABZZ | x | | x | ] x | 
X X X X X 4 

IJHUARCP | x I x J | j x [ 
f + + + + 4 

IJHUARCZ | x | x I x | | x | 

X X X X X ^ 

IJHUARZP I x I x I 1 I x I 
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r T T T- T T 1 

I I I I I PL/I I I 

j ISMOD | | | | Optimizing | American National j 
] Names | COBOL) PL/I |RPGII| Compiler ^Standard COBOL | 

jIJHUARZZ | x | x | x | | x | 

|. + + + + + ^ 

JIJHUASZZ I X | | x | j | 

JIJHUIZCZ | | | x | | | 

jIJHUIZZZ | x | | x | ] | 

j. + + + + + ^ 

jIJHZLGZT | j | I X | | 

|. + 4 + + + + 

| IJHZLGZZ | X ' | | X | | | 

y f + + + + ^ 

JIJHZLZZT 1 | j | X | | 

| IJHZLZZZ | X j x | x | | x | 

| IJHZRBCZ 1 x | | x | | x | 

y + + + + + 1 

|IJHZRBZZ | X | | x | | x | 

1 IJHZRGZT | | | | x | | 

JIJHZRGZZ | X | | sc | | | 

y + + + + + -J 

j IJHZRRCT | | | | X | | 

y + + + f + 4 

jIJHZRRCZ | X j X j X | | X | 

|. f + + + + ^ 

JIJHZRRZT | | | j x | I 

h + + + f + 4 

| IJHZRRZZ | X | X | X | X | X | 

j IJHZRSZT | | | | X J | 

|. + + + + + 4 

IIJHZRSZZ |x|x|x| X | X | 

v f + + + + 4 

(IJHZXGZS {III | | 

L L J. J. J. i i 
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MTMOD 



MTMOD name = UFabcde 



a = F RECFORM=FIXUNB or FIXBLK 

= S RECFORM=SPNUNB or SPNBLK 

= U RECFORM=UNDEF 

= V RECFORM=VARUNB or VARBLK 

= N RECFORM=UNDEF and ASCII=YES 

= R RECFORM=VARUNB or VARBLK, and ASCII=YES 

= X RECFORM=FIXUNB or FIXBLK, and ASCII=YES 

b = B READ=BACK 

= Z READ=FORWARD, or READ is not specified 

c = C CKPTREC=YES 

= Z CKPTREC is not specified 

d = W WORKA=YES is specified 

= Z WORKA is not specified 

e = M ERREXT=YES and FDONLY=YES 

= N ERREXT=YES 

= Y RDONLY=YES 

= Z neither is specified 



MTMOD 
Names 



COBOL 



PL/I 



RPGII 



T T 

PL/I 
Optimizing 
Compiler 



American National 
Standard COBOL 



IJFFBCZN 



h 

H 

IJFFZCZZ 

IJFFZZZN 
I" 



IJFFBCZZ 
IJFFBZZN 



IJFFBZZZ 



IJFFZCZN 






IJFFZZZZ 

h 

h- 

IJFRZZWN 

IJFRZZWZ 

\- 

IJFRZZZN 

IJFRZZZZ 

h 

IJFSZCWN 

IJFSZCWZ 



IJFNBZZN 



IJFNZZZN 












IJFSZZWN 
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r T T T T T 

I I I 1 I PL/I J 

|MTMOD | J j | Cptinii zing | Artie ri can National 
| Names |COEOL|PL/I ]RPGII| Compiler | Standard COBOL 
h + + + + + 

IIJFSZZWZ | j j X | | 

h + + + + + 

JIJFUBCZN | | | | X J 

IIJFUBCZZ | X | | | | 

h f + + + + 

|IJFUBZZN | | | | X J 

h + 4——+ + + 

IIJFUBZZZ | | x | j | 

|IJFUZCZN J 1 | | x | 

| IJFUZZZN j X | | | X | X 

[IJFUZZZZ j X | x | ] | X 

L + + + f + 

IJFVBCWZ | x j J | | 

[IJFVBCZZ | x j j j | 

IJFVZCWN | | | x | | 
h + + + + + 

IIJFVZCWZ | | | x | | 

+ + + + + 

IJFVZCZN | | | j x j 

[IJFVZZWZ | | | X | | 

IJFVZZZN | X | | | x | x 
r f + + + + 

IJFVZZZZ | X | x | | | x 

IJFWEZZN | | | | X | 
+ + + + + 

IJFXBZZN /j j | | x | 
4 + + + + 

IJFXZZZN | | | x | x | 
f + + + + 

IJFXZZZZ I I I x I 1 
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Name list for work file type modules (TYPEFLE=WORK) : 

MTMOD name = IJFabcde 

a = W always 

b = E ERROPT=YES 

= Z ERROPT is not specified 

c = N NOTEPNT=YES 
= S NOTEPNT=POINTS 
= Z NOTEPNT is not specified 

d = Z always 

e = M ERREXT=YES and RDONLY=YES 

= N ERREXT=YES 

= Y RDONLY=YES 

~ Z neither is specified 

S ystem I/O Modules 



IJFWEZZZ 
IJFWZNZZ 
IJFWZZZZ 



Note : See "Required IOCS Modules" before deleting modules with the IJF prefix. 
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PRMOD 

PRMOD name = UDabcde 

a = F RECFORM=FIXONB 

- V RECFORM=VARUNB 
= (J RECFORM=UNDEF 

b = A CrLCHR=ASA 

= Y CrLCHR=YES 

= C CONTROL=YES 

= S STLIST=YES 

= Z neither CTLCHR nor CONTROL nor STLIST is specified 

= U DEVICE=2560 

= V DEVICE=5425 

= T DEVICE=3525 with 2-line printer, and FUNC-XXT 

c = B ERROPT=YES (ERROPT=name in DTFPR) and PRINTOV=YES 

- P PRINTOV=YES, DEVICE is not a 3525, and ERROPT is not specified <ERROPT=RErRY or 

omitted in DTFPR) 

= I PRINTOV=YES, DEVICE=3525, and FUNC=WT or omitted 

~ F PRINTOV=YES, DEVICE=3525, and FUNC=R»T 

= C PRINTOV=YES, DEVICE=3525, and FUNC=PtfT 

= D PRINTOV=YES, DEVICE-3525, and FUNC=RP*r 

= Z neither ERROPT (ERROPT-RETRY or omitted in DTFPR) nor PRINTOV is specified, and 

DEVICE is not a 3525 

= O PRINTOV=YES is not specified, DEVICE=3525 and FUNC=MT or omitted 

= R PRINTOV=YES is not specified, DEV1CE=3525 and FUNC=RWT 

= S PRINTOV=YES is not specified, DEV1CE=3525 and FUNC=PWT 

= T PRINTOV=YES is not specified, DEViCE=3525 and FUNC=RPWr 

- E ERROPT=YES (ERROPT=name in DTFPR) and PRINTOV=YES is not specified 
= U DEVICE=2560 or 5425 and FUNC=W or omitted 

= V DEVICE=2560 or 5«l25 and FUNC^Ri* 

= W DEVICE=2560 or 5U25 and FUNC=PW 

= X DEVICE-2560 or 5<»25 and FUNC=RPtf 

d = I I0AREA2=YES 

= Z I0AREA2 is not specified 

e = V RDONLY=YES and WORKA*YES 

- W tfORKA=YES 
= Y RDONLY=YES 

= Z neither is specified 

Note : To obtain support for the TRC parameter for the 3800 printer when extended 
printer buffering is not being used, reassemble the required logic modules with 
TRC=YES specified. 
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r T T T T T 1 

I ill! pl/i I I 

j PRMOD j j | j Optimizing | American National! 
| Names |COBOL,jpL/I | RPGII | Compiler | Standard COBOL j 
,. x x x x x ^ 4 

IIJDFAOIZ | X | | | x | | 

j. .{. + x x x 4 

|IJDF0lOZZ I X I I I x I I 

I. X X X + X + 

IIJDFAPIZ | x | 1 | | x | 

I. x + x x x j 

|IJDFAPZZ | x | | | | x j 
|. x x x + x ^ 

IUDFARIZ | X | | | X | | 

^ + + 1 + + * 

|IJDFARZZ | X j | | x | j 

|. x x x x x ^ 

JIJDFA.SIZ | X | | j X | | 

j. X + x + x j 

|IJDFASZZ | X | | | X | I 

y x x + + x ^ 

JUDFAHZ I X I I I X I I 

j. + + x x x < 

|IJDFMZZ | X | | | X | | 

(. x x + x x ^ 

IIJDFAZIZ | | x | | x | | 

^ + x x X x 4 

IIJDFAZZZ | | X [ | x | | 

|. x -j. X x X 4 

IIJDFTOIZ i i i I x i I 

h + + x x x ^ 

IIJDFIOZZ I I I I x I I 

IIJDFTRIZ | | | | X | | 

I- + + + "I- f "I 

[IJDFrRZZ | 1 | | X | | 

IIJDFTSIZ | | | | X I | 

V X + X X X 4 

lUDFISZZ I I I I X i I 

t + + + + + 4 

juDFrnz j j | | x | j 

h + + x x x 4 

liJDFrrzz | | | | x | I 

j. =_x x x x x 4 

|IJDFUUIZ | X | | J x | | 

h + + + + + "I 

|IJDFUUZW | | | X | | | 

j. x x x + x 4 

JUDFUUZZ | X | | | X | | 

J. + X + X X 4 

|IJDFUVZW | | | X | | | 

j. x x x + x 4 

JIJDFOWZW | | | X | | | 

I" + + 1 1 + 4 

JIJDPUXZW | | | x | | | 

I- 4- + + + f 4 

IIJDF7LFIZ | | | | X | | 

|. + + X X X 1 

I I JDFVCJZW | | | x | | | 

I- + "I" + + + \ 

|ijdfvozz I I I ! x I I 

j. + x — .— x x x 4 

jIJDFVVZW | | | x | | | 

L X X X X X J 
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r T T T T T 1 

I I I I I PL -/I | I 

| PRMOD | J | J Optimizing | American National! 
| Names (COBOL) PL/I |RPGII| Compiler | standard COBOL j 
h + + 4. 1 1 ^ 

JIJDFVWZW | I | x | | | 

I. 1 + + + + 4 

|IJDFVXZtf | | | x | | | 

j. + + x 1 4. 4 

JIJDFYOIZ | | | | x | | 

h + + + + + 4 

|IJDF3fOZW j | | x | | | 

t — X + 4. 4. i ) 

|IJDFYOZZ | | | | x | | 

j. x x x 1 x 4 

JIJDFYPZW | I j I i I 

|IJDFYRIZ | | | | X | | 

j. X x X f 4. 4 

|IJDFYRZtf I I | X | j | 

,. x x x x x 4 

|IJDFYRZZ I I 1 I X I I 

h 4. 4. 4. 1 4. 4 

JIJDFYSIZ j j I j x j I 

i- +— — 1- + + + ^ 

jIJDFYSZtf j j j x I I j 

j. + 4. 4. 4. _ 4. 4 

JIJDFYSZZ 1 j I I x j I 

|. + 4. + 4. 4. 4 

|IJDFYriZ j I I I x I I 

IIJDFYTZM I I I x j I I 

,. 4. 4. 4. + 4. 4 

|IJDFYrZZ I I I I x I I 

I. + 4. 4. 4. 4. 4 

IIJDFYPIZ I 1 I I I x I 
|. 4. 4. + 4. 4. 4 

IIJDFYPZZ j X j j j j x I 

t 4. x 4. 4. 4. 4 

[IJDFYZIZ j j x j j x I j 

,._„ 4. 4. x 4. 4. 4 

IIJDFYZZZ I j x I j I x I I 

I" +-■ + + + * i 

jlJDFZOIZ j X j j j X I I 

j. 4- 4. 4. + 4. 4 

IIJDFZOZZ I X J I I x J I 

h + 4. 4. 4. 4. 4 

[IJDFZPIZ I x I x j I I x I 
f. 4. 4. 4. 4. 4. 4 

IIJDFZPZZ J x I x I I I x I 
h 4. 4. 4. x 4. 4 

JIJDFZRIZ I X I j j x j I 

j. 4. 4. 4. 4. 4. 4 

IIJDFZRZZ I X I I j x j I 

h x 4. 4. 4. 4. 4 

JIJDFZSIZ j X j j j x I j 

|. 4. 4. 4. 4. 4. 4 

JIJDFZSZZ J X j j I x j I 

j. 4. 4. 4. 4. 4. 4 

jIJDFZriZ j X j j j x j j 

j. 4. 4. 4- 4. 4. 4 

|IJDFZrZZ I * I I I x 1 I 

Y x 4. x 4. 4. 4 

IIJDFZZIZ j I I j x j I 

|. 4. -4. 4. 4. 4. 4 

IIJDFZZZZ I j j I x j j 

L X X X X X J 
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r T T T T T 

I I I I I PL/I I 

| PRMOD | J J j Optimizing j American National 
| Names | COBOL) PL/I | RPGII | Compiler j Standard COBOL 
h + + 1 + x 

(IJDUAOIZ | X | | | X | 

j. + X + X X 

JIJDUAOZZ j X j | I x | 

i + + + + + 

|IJDUAPIZ | X | | | | X 

h + + + + + 

|IJDUPlPZZ I x I I I I x 

I- + + + + + 

IIJDUARIZ | X | | | x | 

Y + X + X x 

|IJDUARZZ | X | | | x | 

j. X X X X X 

(UDUASIZ | X | | | x | 

h +— — + + f + 

|IJDUASZZ | X | | | X | 

h + + + + + 

lUDtmriz | x | | | x | 

Y + x x x + 

Iijduaizz | x | | | x | 

* + -I- + 1 + 

IIJDUAZIZ | | | | x | 

|. + X x x X 

jIJDUAZZZ I | | | X | 

|. X -j- X + X 

lUDuroiz | | | | x | 

j. + + + + + 

|UDurozz | | | | x | 

h + + + + + 

JIJDuTRIZ j j j j I X I 

j. X X X X X 

IIJDUrRZZ I I I I x i 

I- X X X X X 

|UDursiz | | | | x i 

Y + + + x x 

IIJDUTSZZ | | | | X | 

I- + + + + + 

liJDurnz I I | I x | 

I- + + + + — + 

IIJDUTTZZ I I I I x i 

f. X X X + X _ 

IUDUOUIZ I X I I I x I 

Y + + X X X 

IIJDUQQZZ | X | | | x | 

|. X X X X X 

\IJDUVUIZ | | | | x | 

h + x x x x 

IIJDUVUZZ | | | | X | 

IIJDU^OIZ | | | | X | 

J. + + x x x 

IIJDUYOZZ | | | | X | 

j. X X X X x 

|UDuypiz | x | | | | x 

j. + x + x x 

|IJDUYPZZ | X J | | | x 

h -I- f + + + - 

|IJDUrRIZ I I I I x I 

h + + + + + 

|IJDUYRZZ | 1 | | x j 

h + + + + + 

IIJDUYSIZ | | | | x | 

L J. X X X X 
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r T T T T T 1 

I I I I I PL/I | | 

| PRM0D J I | j Optimizing | American National j 
| Names j COBOL j PL/I |RPGII| Compiler | Standard COBOL | 

j. x x x 1 x 4 

JIJDUYSZZ j | | | x | j 

(. X X + X X 4 

|IJDU5friZ I I I I x I I 

h _± + X X f 4 

|IJDUYrZZ I I I I X I I 

h __ x x + + x 4 

jIJDUJfZIZ | | | | x | | 

j. + x x x x 4 

IIJDUYZZZ | 1 | j x | | 

I- 1 "I- + + f 1 

|IJDUZOIZ | X | | | X | | 

(. x X x X X 4 

IIJDUZDZZ | X | | j x | | 

j. + X X X X 4 

IIJDUZPIZ | X | | | | x | 

l + + + 4. 4- 4 

|IJDUZPZZ | X | | | | x | 

J. 4. 4. 4. x 4. 4 

JIJDUZRIZ j X j j j X I I 

y + + 4. 4. 4. 4 

IIJDUZRZZ I X I I I x I I 

f + + + 1 f i 

IIJDUZSIZ I X I I J x I I 

Y + 4- 4. f 4- 4 

JIJDUZSZZ j X j j j x I I 

|. 4. 4. 4. 4. 4. 4 

lijDuznz 1 x 1 1 1 x 1 I 

h + + + + -I- * 

liJDUzrzz j x j j j x j I 

j. 4. 4. 4. + 4. 4 

jIJDUZZIZ I I I I X j I 

j. 4. 4. 4. 4. 4. 4 

JIJDUZZZZ I I I I X I I 

l x 4. 4. x x 4 

|IJDVkOIZ j X j J I X I I 

h + x 4. 4. 4. 4 

|IJDV?VOZZ j X j j j X j I 

h + f + + + i 

|IJDVAPIZ I X I I I I x I 

l . + + 4. 4. 4. 4 

IIJDV&PZZ j X J I j I X I 

|. 4. 4. 4. 4. 4. 4 

IIJDVARIZ j X I I I x j I 

[ 4— + + + 1 4 

[IJDV&RZZ j X I I I X I I 

h 4. 4. 4. 4. 4. 4 

(IJDVkSIZ j X 1 j I X I I 

J. + 4. 4. 4. 4. 4 

IIJDVASZZ I X I I j X I I 

h + 4- + + + "I 

|UDv&riz I x 1 1 j x I I 

Y + 4. 4. 4- 4. 4 

JIJDVMZZ I X I I j x J I 

j. 4- 4- 4. 4. 4. 4 

IIJDVAZIZ I 1 I I x I I 

h 4. + 4. x 4. 4 

JIJDVA.ZZZ I 1 I I X j I 

h 4. 4. 4. 4. 4. 4 

|UDvroiz I I I I x 1 I 

t X X X X X J 
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r T T T T T 1 

I I I I I PL/I J | 

JPRMOD J I J j Optimizing! American National! 
| Names j COBOL| PL/I j RPGII | Compiler | Standard COBOL j 

y + + + + + ^ 

juDvrozz l j I j x | | 

^ + + + + f ^ 

IIJDVrRIZ I I l I x j I 

J. 1 1 + 1 + .j 

|IJDVrRZZ I I I I x I I 

J. — + + 1 + J. 4 

jUDvrsiz I I I I x j I 

I. + 1 + + + 4 

lUDvrszz | | I | x | I 

j. 1 + 1 J. 1 1 

lUDvrriz | | | | x | | 

j. f + + + + -i 

jijDvrrzz j j j I x j | 

I- + + + f + i 

lUDvauiz I I I I x | | 

i- + + + + + ^ 

JIJDVUOZZ | X | | | x | | 

h + + + + + 4 

IIJDVVUIZ | X j | | x | | 

h + + + 1 + .| 

[IJDVVUZZ | | | | X | | 

\. + + + + + -j 

JIJDVYOIZ | | | | x j | 

i- + + + + + ^ 

jIJDVSfOZZ | | | | x | I 

j. 1 + 1 + f ^ 

IIJDVYPIZ | X J | | | x | 

|. 1 1 + + + ^ 

(IJDViTPZZ I X j j | | x | 

I" + + + + 1 1 

JIJDVYRIZ | | | | X I | 

h + + + 1 + " i 

|IJDViTRZZ | | | | x | | 

h + + + f + ) 

IIJDVYSIZ | | | | x | | 

|. + + 1 + + 1 

JIJDVZSZZ j | | | x | | 

IIJDVYHZ | | | | x | | 

h + + + + f "I 

lUDvrrzz I I I | x | | 

[ + + + -I- + \ 

IIJDVYZIZ | | 1 | x | | 

(. + 1 + + + ., 

[ijdvyzzz I i I | x | | 

h + + + + + ^ 

|IJDVZOIZ | X | | | X | | 

|. + + + + + ^ 

JUDVZOZZ | X | | | x | | 

h + + + _ ; + f ] 

IIJDVZPIZ | X | | | | x | 

h + f + + + * 

IIJDVZPZZ | X | | | I X | 

j. + + + + 1 < 

IIJDVZRIZ | X | j j X | | 

h + + + + 1 1 

IIJDVZRZZ | X | | | k | | 

h + + + f f ] 

IIJDVZSIZ I X I I I x I I 
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T T T T T 1 

I I I I PL/I | 

PRMOD | i | | Optimizing | American National 
Names | COBOL j PL/I |RPGII| Compiler | Standard COBOL 



I- 

|IJDVZSZZ | X | 
h f h 

jiJDVznz j x | 

Y + +- 

lUDvzrzz j x | 
,. + + . 

IIJDVZZIZ j j 
V + +. 

IIJDVZZZZ | | 
L i j.. 



SDMOD 



SDMODxx name - IJGabcde 

a = C RECFORM=FIXUNB or FIXBLK and HDLD=YES 

- F RECFORM=FIXUNB or FIXBLK and HDLD is not specified 

= P RECFORM=SPNUNB or SPNBLK and HDLD^YES 

= Q RECFORM=SPNUNB or SPNBLK and HOLD is not specified 

= R RECFORM^UNDEF and HOLD=YES 

= S RECFORM=VARUNB or VARBLK and HOLD=YES 

= U RECFORM=UNDEF and HOLD is not specified 

= V RECFORM=VARUNB or VARBLK and HOLD is not specified 

b = I SDMODxI (non-RPS version of module) 

= SDMODxO (non-RPS version of module) 

= SDMODxU (non-RPS version of module) 

= W SDMODxI (RPS input data set ) 

= X SDMODxO (RPS output data set) 

= Y SDMODxU (RPS update data set) 

c = C ERROPr*YES and ERREXr=YES 

= E ERROPI=YES 

= Z neither is specified 

d = M TRUNCS^YES and FEOVD=YES 

= T TRONCS=YES 

= W FEOVD=YES 

= Z neither is specified 

e = B CONTROL=YES and RDONLY-YES 

= C CONTROL=YES 

= Y RDONLY=YES 

= Z neither is specified 
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r T T T T T ~ '""-I 

I I I I I PL/I j I 

I SDMOD j | | | Optimizing! American National! 
| Names j COBOL j PL/ I |RPGII| Compiler | Standard COBOL j 
h + + 4. 4. x 4 

JIJSCYCMB | I I I j | 

i- f + + + + ^ 

|IJGCZCtfB | | i | | I 

y + X X X 4. 4 

|IJGFICZZ I I I x j x J I 

|. + 4. + 4. 4. ^ 

JUGFIEIZ j x I X j I j I 

h + + X X 4. 4 

IIJGFIEWZ I X j I I J X I 

f X 4. + + + 4 

JIJGFIEZZ j x j X j j j I 

J. x 4. + X 4. 4 

IIJGFIZZZ I x J j x j I I 

I- + f + + + i 

IUGFOCZZ j I I X I x j I 

j. 1 + 4. 4. 4. ^ 

I IJGFOEWZ I X I I j j X I 

y x + 4. 4. X .| 

IIJGFOEZZ J J x j I I I 

h + + + f + i 

|IJGFOZZZ j x J | X I I j 

i- + + + + + — ^ 

|IJ3FUCZZ I I I X J X I I 

I. + 4. 1 x 4. 4 

JUGFUETZ j j X j J j j 

|. + x 4. x 4. 4 

|IJGFJEtfZ I X I I I I X I 

I- + + + 1 + i 

jIJGFUEZZ I I x j I I I 

,. X x x x X - H 

(IJGFUZZZ 1 x 1 1 x 1 I I 

j. x + x x 4. 4 

IIJGFtfCMB I I I i I I 

J. X f x x 4. 4 

|IJGFtfCtfB I I I I I I 

v + + + 4. 4. 4 

IIJGFXCMB I j I I I I 

I- + + + + + -I 

IIJGFXCMB I I j j I I 

t + 4. x 4. 4. 4 

IIJGPYCWB till I I 

J. x 4. x + 4. 4 

IU3QICZZ I I I X I I I 

J. + x 4. 4. 4. 4 

|IJGQIEWZ I X I I I I X j 

h x 4. 1 4. 4. 4 

JIJ3QIEZZ I I 1 I j X I 

1- + + + 1 * ^ 

JIJGQIZZZ I I I x j j j 

,. x 4- + 4. _ — 4. 4 

IIJGQOCZZ I I I x I j I 

Y X 4. x 4- f 4 

IIJGQOEWZ j X I I I I X I 

|. 4- 4. X 4. —4. 4 

|IJGQOEZZ I I j I I X J 

Y x x x 4. 4. 4 

IIJGQOZZZ I I I X j I I 

,. 4. 4. 4. 4. x___ 4 

JIJGQUCZZ I I I X I I I 

j. + 4. 4. 4. f 4 

I IJGQUEWZ I X J I I I X I 

I X X X X X J 
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r T T T T T 1 

I I I I I PL/I I I 

|SDMOD | | | j Optinizingj American National j 
| Names | COBOL | PL/I |RPGII| Compiler | Standard COBOL | 
(. + + x x x ^ 

|IJ3QUCZZ | | | x | | I 

J. + x + x x H 

|IJ3QUEZZ | | | | I X | 

J. X X X X X___ < 

|IJ3Q(JZZZ | | | X | | | 

h + + + + 1 ^ 

|IJ3QtfCWB | | | | I | 

|. x X x X X ) 

|IJ3QXCtfB till | | 

j. + X X X X < 

|IJGR¥CtfB 1 | | | I I 

j. x x x x + ., 

JIJSSYCMB | | | | | | 

h + + + f f ^ 

|IJ3UICZZ | | | | x | | 

I" + I + + + * 

|IJ3UIEtfZ | X | | | | x | 

h + + + + f ^ 

|IJ3UIEZZ | x | X | | | | 

I. + x x + + ^ 

JIJ3UIZZZ I x I I I | | 

J. + . X + x x i 

IIJ3UOCZZ | | | | X J | 

y + x + x _x ) 

|IJ3UOEtfZ | X | | | | x | 
j. + X x 1 L ] 

|IJ3U0EZZ | | X | | | | 

I- + + + + + 1 

JIJ3U0ZZZ | x j | | | | 

J. X + X X X ^ 

[IJ3UUCZZ | | | | X | | 

I. x x + + x 4 

|IJ3UUEtfZ I x i i i I x i 

h X + X X X < 

|IJ3UUEZZ | | X | | | | 

(. x + 1 1 + ^ — ^ 

JIJ3UUZZZ 1 x | j | | j 

j. + + x x x _ < 

|IJSUWCWB | | | | I I 

IUSUXCWB | | | | | | 

h + + + + — _ x ^ 

JIJ3VIEWZ | X | | | | X | 

j. X X X X X ., 

IIJGVICZZ | | | x | x | | 

j. + x x x L < 

|IJ3VIEZZ | x | x | | | | 

I- + -1- + + + — 4 

JIJ3VIZZZ I x I I x I J | 

y + + + x f ^ 

|IJ3V0CZZ | | | x | x | | 

|. x x x + x j 

|IJ3V0EtfZ | X | | | | x | 

j. + + + f l ^ 

|IJ3V0EZZ | | x | | | I 

h x x x x x ., 

|IJ3V0ZZZ | x | | x | | | 

h + + + +■ f ] 

JIJ3VUCZZ | | | x | x 1 | 

j. + + 1 + + .J 

IIJGVUEtfZ | X | | | | x | 
L X X i i X J 
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r t — ■ t t t t ^ 

I I I 1 I PL/I I I 

I SDMOD | | | | Optimizing! American National) 
| Names |COBOL|PL/I | RPGII | Compiler j Standard COBOL | 
h + x x x + i 

|IJ3VUEZZ ] | X | | | | 

j. x x + x x .j 

JIJ3VCJZZZ | X | | * | | ) 

I- + + + + f 1 

| I J3VWCWB | I I I I I 

I. + x + + + ^ 

|IJ3VXCtfB | | | | | I 

h X X X x x j 

|IJ3WCZZU | | | | X | | 

y x x + x + ^ 

JIJGWCZZZ I I I I x I I 

L X X X J. X i 



Nft-ME LIST FOR tfORK FILE ryPE MODULES ( rYPEFLE= tfQR K) 

SDMODxx name = IJGabcde 

a = r SDMODW specifies tfOLD=YES 

= W SDMODW does not specify HOLD=YES 

b = C ERROPT=YES and ERREXr=YES 

= E ERROPT=iTES 

= W RPS version of module 

= Z neither is specified 

c = N NOrEPNr=YES 

= R N0TEPNr=POINrRtf 

= Z NOIEPNT is not specified 

d = C C3NTR0L=YES 

= Z CONTROL is not specified 

e = T RDONLY=YES and UPDA.TE = YES 

= U UPDATE=YES 

= Y RDONLY=YES 

= Z neither is specified 

S£Stem_I/0_Modules 

IJSTWNCr 

IJ3tfEZZ(J 
IJGWEZZZ 
IJGtfZNZZ 
IJ3WZRZZ 



Note: See "Required IOCS Modules" before deleting modules witn tne IJG prefix. 
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DUMOD 



DUMODFx name = IJNabcde 



a = D 

b = I DCJMODFI 
= OUMODFO 

C = C ERROPT=YES and ERREXr=YES 
= E ERROPT=YES 
= Z neither is specified 

d = Z 

e = Y RDONLY=YES 

= Z RDONLY not specified 

r T T T T T 1 

I I I I I PL/I | I 

| DUMOD | | | | Optimizingl American National | 
| Names | COBOL j PL/I |RPGII| Compiler j j Standard COBOL | 

JIJNDICZZ | j j x j x j 



I" 

IJNDIZZZ | | | x | | 



t + + + + +" 

IIJNDOCZZ | | j x | x | 



v + + +- 

JIJNDOZZZ j | \ 
L i X -L. 
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Required IOCS Modules 



The following preassemDled IOCS modules are required when cataloging and/or link-editin; 
IBM components to the core image library. 

M23ule_Names ly_tes_gf _SJtorage 

IJFFZZWN 960 

IJFrfEZZZ 280 

IJFWZNZZ 424 

IJFrtZZZZ 232 

IJ3FIETZ 746 

IJ3tfEZZU 868 

IJGWEZZZ 796 

IJ3tfZNZZ 902 

IJ3WZRZZ 840 

IJJCPA1N 838 

IJJCPDV 750 

IJJCPDV1 694 

IJJCPDV2 358 

IJJCPD0 854 

IJJCPDON 798 

IJJCPD1 718 

IJJCPD1W 762 

IJJCPD2 478 

IJJCPD3 350 

IJJCPtf 343 

IJJCPV1 271 

IJJCPV2 68 

IJJCP0 389 

IJJCP0N 317 

IJJCPl 311 

IJJCP1N 239 

IJJCP2 128 

IJJCP3 58 

IJNDIEZZ 868 
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Module 8: Direct Access -- 5745-SC-DAM 
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r t 1 

j Number of | Core Image | 

I Transients j Library Blocks j 
h 1 H 

I 11 I 12 | 

L J J 

?£§:0.sients 

$$BODACL 
| $$BODAIM 
$$BODAIN 
$$B0DAI1 
$$B0DA01 
$$B0DA02 
$$B0DA03 
$$B0DA04 
$$BODARP 
$$BODARS 
$$B0DAU1 

r t 1 

| Number of j Source Statement | 
j Macros j Library Blocks | 
j. 1 ^ 

I 3 | 1,268 | 

L J. J 

SOURCE STATEMENT LIBRARY 

File_Def inition_Macros 

E.DAMOD 
E. DAMODV 
E.DTFDA 

§torag_e_Reguirements 

Figure 8-1 defines the storage requirements for DAMOD. The following are the storage 
requirements for DTFDA. 

DI£DA_^Def ine_The_File^__Direct-Access_Devi 

RECFORM=FIXUNB requires 205-225 bytes, depending upon imperative macros used in tne DTF. 
VERIFY=YES requires 40-80 bytes, depending upon imperative macros used in the DTF. 
AFTER=YES requires 80 additional bytes. 



Support for RPS requires 512 bytes for each open DTFDA to be available in the GE1VIS area 
of tne partition. This area is allocated during open; it is used to generate RPS cnannel 
programs. 

RECFORM=SPNUNB requires 282-378 bytes, depending upon the imperative macros used in the 
D1F. 

VERIFY=YES requires 64-72 additional bytes, depending upon tne imperative macros used in 
the DTF. 

AFTER=YES requires 88 additional bytes. 
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RECFORM=UNDEF requires 265-285 bytes, depending upon the imperative macro used in the 
DTF. 

VERIFY=YES requires 40-80 additional bytes, depending upon the imperative macros used in 
the DTF. 

AFTER-YES requires 16 additional bytes. 

RECFORM=VARUNB requires 216-330 bytes, depending upon the imperative macros used in the 
DTF. 

VERIFY=YES requires 64-72 additional oytes, depending upon the imperative macros used in 
the DTF. 

AFTER-YES requires 88 additional bytes. 

Relative addressing increases the size of the DTF 60-80 bytes plus 8 bytes per extent. 
(See DOS/VS Supervisor and I/O Macros listed on the front cover of tnis manual.) 

DAMOD ^Direct- Access _Deyice^Module^ 

r 1 

| Formatting] 
j Module | 

r — ' T T + + T T T T 1 

j III | AFTER j | j |RPS Version | 
I j Basic j j | and) j | | of | 
|RECFORtf=|ModulejlDLOC| AFTER | IDLOC | RELTRK j HOLD | ERREXT| Logic Module j 
,. X + x x x x x x < 

JFIXUtfB | 636 I +180 j +304 j + 484J +212 j + 84| +28 | 1948 j 
|. x x X X X X x X -I 

|UNDEF | 796 | +208 | +216 | +426| +208 | +88 | +28 | 2152 | 
L— — + x x x x x x x H 

|VARUNB | 686 | +210 | +298 | +508 | +226 | +84| +34 | 2084 | 
^ X x + x x x x x i 

JSPWUNB |2320 | +316 | +1004 |+1320| |+104| +32 | 4096 1 

L X X X X X X X X J 

Figure 8-1. DAMOD — Storage Requirements 

Notes : 

1. Basic Module includes coding to handle either FIXUNB or UNDEF records and the 
WRITEKY, READKEY, READID, WRITEID, SrtCHM, VERIFY, and CONTROL functions. 

2. AFTER includes coding to create the tile and to handle tne RZERO option. 

3. IDLOC includes coding to return tne record identifier to tne user in a location ne 
specifies. 

4. Specification of trailer label processing in the DTF increases tne size of each 
module by 50 + 20 bytes. 

5. RDONLY=YES changes the size of the module -50 to +50 bytes. In addition, the user's 
program must provide a 72-byte save area each time the module is reentered. 

6. RELTRK may be specified for SPNUNB records. This specification requires no 
additional bytes. 

7. RPS versions of tne logic modules include support for all otner valid options for 
each record format. 
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Module 9: 3540 Diskette I/O Unit IOCS - 5745-SC-DIO 
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j Libraries j 


j Core Ima 


T 

ge | 


Source 


Statement j 


L ~ ~ t 

| Transients | 

L J. 


Blocks | 
j 


Macros 


1 

_X 


Blocks j 


r t 

1 19 | 

L X 


19 | 
x_ 


3 


T 

1 
_X 


503 | 



CORE IMAGE LIBRARY 



Transients 



$$ABERR7 
$$BODIOl 
$$B0DID2 
$$B0DI03 
$$B0DI04 
$$BODI05 
$$B0DI06 
$$BODI07 
$$B0DI08 
$$BODMS3 
$$BODMS2 
$$ BODS MO 
$$BOD3P0 
$$BODUCP 
$$BOVDMO 
$$BOWDMO 
$$B3540I 
$$B3540O 
$$B35400 



SOURCE STATEMENT LIBRARY 



File Definition Macros 



E. DTFDU 

E.DUMODFI 

E.DUMODFO 



Storage ^Requi reme nts 

Figures 9-1 and 9-2 specify the storage required by DTFDU and DUMOD. 



DTFDU , (Define The_File_ Diskette Unit) 

r t 

| | CMDCHN 

| y 

| TYPEFLE 1 1 2 13 26 
h + 

| INPUT | 152 160 248 352 
h x 

j OUTPUT j 160 168 256 360 

L X 

Figure 9-1. DTFDU — Storage Requirements 
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DUMOD_(.Diskette_Unit_Module). 

r t t t t t ~t 1 

| Module J Basic j RDONL* j ERROPT j ERROPT | ERROPT | ERROPT j 
I rtaie | Module j | j RDONLY j ERREXT | LRREXT | 

I I I I I I I RDONLYM 
^ X X X X x x j 

| DUMODFI | 788 j 776 j 868 | 848 | 924 j 902 | 
h x__ + x x x x ^ 

| DUMODFO | 632 | 594 | 696 | 642 | 1078 | 1024 | 
[. X X X X X X .) 

| *-For RDONLY=YES, the user's program mist provide a 72-byte save area j 
| eacn time the module is reentered. j 

L J 

Figure 9-2. DUMOD — Storage Requirements 
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r t 1 

| dumber of | Core Image | 

| Transients j Library Blocks j 
y 1 ] 

j 26 | 34 | 

L X J 

l£=LQliierits 

$$BCIS0A 

$$BENDFF 

$$BENDFL 

$$BINDEX 

$$BOISRP 

$$BOIS01 

$$BOIS02 

$$BOIS03 

$$BOIS04 

$$BOIS05 

$$BOIS06 

$$BOIS07 

$$BOIS08 

$$BOI309 

$$BOIS10 

$$B0IS11 

$$B0RTV1 

$$B0RTV2 

$$BSETFF 

$$BSETF3 

$$BSETFH 

$$BSETFI 

$$BSETFL 

$$BSETL 

$$BSETL1 

$$BSETL2 



r t 1 

| Number of | Source Statement | 
I Macros j Library Blocks j 
h + ., 

i 6 I 2,717 | 

L J_ J 



SOURCE STATEMENT LIBRARY 

Macros 

FILE_DEFINITION 

E.DTFIS 
E.ISMOD 

IMPERATIVE 

E.ENDFL 
E.ESETL 
E.SETFL 
E.SETL 
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Storage, Requirements 

Figure 10-1 defines the storage requirements for ISMOD. The storage requirements for 
DIFIS are: 

£rFIS_U)ef ine_the_File^Lndejced_Se3uentiai 

1. IOROUr=LOAD requires 248 bytes plus 4 bytes per disk extent specified, plus 8 bytes 
for IOAREA2. 

2. IOROOT-ADD requires 530 bytes plus 4 bytes per disk extent specified plus KL (tne 
length of the key) . 

3. IOROUI=RErRVE requires 276 bytes plus 4 bytes per disk extent specified, wnen 
iyPEFLE=SEQNTL. 

4. IOROUT=RErRVE requires 292 bytes plus 4 bytes per disk extent specified when 
TrPEFLE=RANDOM or RANSEQ. 

5. IOROuT=ADDRTR requires 548 bytes plus 4 bytes per disk extent specified plus KL (the 
length of the key) . 

6. I0R0CJr=ADDRTR, TYPEFLE=RANDOM, INDAREA=name, and INDSIZE=n require 572 bytes plus 4 
bytes per disk extent. 

7. Support for RPS requires 384 bytes for each open DTFIS to be available in the GETVIS 
area of the partition. This area is allocated during open; it is used to generate 
RPS channel programs. 

ISMOD_ (Indexed ^Sequen tia l, Module) 
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Figure 10-1. ISMOD Storage Requirements (Part 1 of 5) 
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Figure 10-1. ISMOD storage Requirements (Part 2 of 5) 



| RECFORM= 

i- 

M 
h 



IOROUT=ADDRTR 



TYPEFLE= 



RANDOM 



SEQNTL 



. T T T T 1 

j CORDATA JERREXT | CORDATA | HOLD | 



I I 



ERREXr 



*T T T T 

J CORDATA | IOAREA2 j HOLD | ERREXI 



--'i'-^^'^—^^'^^^r^—---r—i 



FIXUNB 



3252 |+320 



(+534 



+ 718 



j +304 J3502 |+94 



1+386 |+278 |+510 
4 x + 

1+386 |+278 |+528 



FIXBLK 
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j+554 
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1+304 |3716 |+272 



BOTH 
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x X 
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Figure 10-1. ISMOD Storage Requirements (Part 3 of 5) 



| RECFORM= 
^ 

| FIXUMB 
j. 

| FIXBLK 

F 

j BOTH 

L 



IOROUT=ADDRTR 



1 

I 
1 

TJfPEFLE=RANSEQ j 

T T T T ^ 

| CORDATA] ERREXTJ CORDATAJ HOLDJ 
| , j. ^ | 

| | JERREXT | | 

I II II 
X x X x < 

4266| +316 | +556 j +750 |+384| 
X + X x j 

4494| +372 | +584 | +856 |+384| 
X x x X ^ 

4726| +248 | +616 | +864 |+400[ 
x - x x x J 



Figure 10-1. ISMOD Storage Requirements (Part 4 of 5) 
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rtPS Version of Module 



IOROUT= 



LOAD 



ADDRTR 



|1540 

L 



IOAREA2= 



NO 



YES 



t t t r 

I I I HOLD | 
J. X X ., 

| HOLD | CORDATA| CORDATAJ 
y X x ., 



T T T 

I | | HOLD 

| ! j. 

| HOLD|CORDATA|::ORDArA 

I" + + 



| 6828 J +428 J +428 | +852 
.X x x x 



|6478| +340|+426 

.X X X 



J +766 

.j 



Figure 10-1. ISMOD Storage Requirements (Part 5 of 5) 

Notes: 

1. When RECFORM=BOrH is specified, trie module processes FIXUiMB and FIXBLK records. 

2. For CORINDX=YES, add 212 bytes. 

3. RD0NLY=5fES changes the module size by ±50 bytes with the following exceptions. When 
IOROQr=ADD or IOROUT=ADDRTR, the module changes in size +60 to +100 bytes. m 
addition, the user's program must provide a 72-byte save area each time the module is 
reentered, regardless of function. 

4. RPS versions of the ISAM modules include support for all other valid options. 
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Libraries 



:ore Image 



T < 

| Source Statement | 



j. T x T 

| Transients! Blocks | Macros | Blocks | 
h x x x 

18 I 8 I 6 I 278 



CORE IMAGE LIBRARY 



Transients 



Samgle^Problemj 



Phase 



j DisK Extent Numoer 
y T T _. 

|1 |2 |3 
+ x x_. 



. T _. 
14 



ASSEMBLE JSYSL.NK |SYS001 |SYS002 |SYS003 

I I ! 

LINKEDIT | SYSl.lMK |SYS001 |- 

I 1 I 
EXECUTE |- |- |- 
x x x 



$$ABERAO 3895 ERP Phase 1 
$$ABERAP 3895 ERP Phase 2 
$$ABERAQ 3895 OBR record builder 
$$ABERAR 3895 MDE record builder 

$$ABERRS Error Recovery Procedure 
$$BCMR01 CLOSE 
$$BMMR20 Message Writer 
$$BOMR01 OPEN 

SOURCE STATEMENT LIBRARY 



Macros 



Figure 11-1. MICR -- Sample Proolem File 
requirements 



£ILE_DEFINITION 

E-DTFMR 

E.MRMOD 



IMPERATIVE 

E.DISEN 
E.LITE 
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T 




_ T 




|Card C 


ols 


|Card Cols. 


| Cards Retrieved 
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| 73-76 

X 




| 77-80 

-X - 
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T 




T 


(CATALS Z.MCRl 


1 






j BKEND Z.MCRl 


1 $477 




| 0001-0071 


| MCRl Source Deck 


1 






| (71 Cards) 


1 






| BKEND 


1 






| CATALS Z.MCR2 


1 

1 






| BKtND Z.MCR2 


| $477 




| 0001-0115 


| MCR2 Source Deck 


1 






| (115 Cards) 


1 






| BKEND 


1 







L X X J 

Figure 11-2. MICR -- Sample Problem Card 
Decks 



SAMPLE_PROBLEMS 

Z.MCRl 
Z.MCR2 



ST0RA3E_REQUIREMENTS 

DTFMR_iDef ine_The_File_Magnetic_Chiaracter 
Reader) Table Requirements : 

If ADDRESS=DUAL is specified, the table 
requires 264 bytes. 

If ADDRESS=DUAL is not specified, the taole 
requires 250 bytes. 



MRMOD (Magnetic Character Reader Modu le) 

If ADDRESS=DUAL is specified, the module 
requires 1,050 bytes. 

If ADDRESS=D(JAL is not specified, the 
module requires 946 bytes. 



SAMPLE PROBLEM SUMMARY 



Figure 11-1 defines the files required for 
the MICR sample problems. Figure 11-2 
shotfs the sample problem card decks 
retrieved from the source statement 
library. 
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The second 1419 
Reader sample prob 
documents from eac 
character readers 
both with a single 
with a dual addres 
CHECK and tfAITF lo 
that must be press 
least one field fo 
READ OUT control, 
reader are selecte 
zero depending on 
selected field is 
in error are rejec 
listed on a printe 
List feature is pr 
data is printed on 



Magnetic Character 
lem processes 250 
h of two magnetic 
(both of the same type: 

address adapter or both 
s adapter) , using READ, 
gic. The only controls 
ed are PROS SORT ani at 
r the VALIDITY CHECK AND 

Documents from one 
d into pockets one or 
whetner or not the 
present. Documents read 
ted, and all data is 
r. If the Selective Tape 
esent on the printer, 

the leftmost tape. 



Documents from the second reader are 
selected according to a digit in the fiei.d 
read and printed on SYSLST. If manual 
intervention is reguired on the second 
reader, a message is printed on SYSL03. 
Tnis message is: 

INTERVENTION REQUIRED ON FILE2 



Tine program names are Z.MCR1 and Z.MCR2. 
The 1419 sample problems support the 
1255/1259. 



Instructions show how to remove the 
following optional features: 

1. Dual addressing adapter feature. 

2. Batcn numbering. 

3. Pocket lignts. 

4. Selective tape list feature (printer) 



SYSLQ3 Output 

BG // JOB MCR SAMPLE PROBLEMS 

BG // PAUSE END OF MCRl SAMPLE PROBLEM 

BG 

BG INTERVENTION REQUIRED ON FILE2 

BG ECJ MCR 

BG // PAUSE END OF MCR SAMPLE PROBLEMS 



SY§ L^T _ u t p u t _S u m ma r y 

Job control cards 

External symbol dictionary 

Source program listing 

Relocation dictionary 

Linkage editor input diagnostics 

Linkage editor storage map 

Document data listings. 
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r 

| Libraries 

|. T _ 

| Core Image | Source Statement 
h T 1 T 

| Transients] Blocks | Macros | Blocks 
h + + x 

I | 19 J 34 | 2 | 994 

1 L X X X 

S2KE_I^AGE_LIBRARy 

$$BCE0V1 Monitor EOV/EOF 

$$BCMT01 Tape EOF/EOV input-forward 

$$BCMT02 Tape CLOSE-alternate switching 

$$BCMT03 Tape CLOSE input-backward 

$$BCMT04 Tape E0\7 output-forward 

$$BCMT05 Tape CLOSE 

$$BCMT06 Tape CLOSE-work files 

$$BCMT07 Tape-alternate switching 

| $$BCMT08 Tape CLOSE-excluding work files 

$$BOMT0M Tape OPEN message 

$$BOMT0tf Tape OPEN message 

$$BOMT01 Tape OPEN input-forward-standard labels (Phase 1) 

$$BOMT02 Tape OPEN input-backward-standard labels 

$$BOMT03 Tape OPEN output forward-standard label 

$$BOMT0U Tape OPEN output-standard labels 

$$BOMT05 Tape OPEN I/O forward/backward nonstandard/unlabeied 

$$BOMT06 Tape OPEN work files 

$$BOMT07 Tape OPEN input-forward-standard labels (Phase 2) 

$$BONVOL Tape rewriting 



File Definition Macros 

E.DTFMT 
E.MTMOD 



Storage_Reguirements 

Figures 12-1 and 12-2 define the storage requirements for DTFYLT and MTMOD. 

DrFMT_(^Def ine_The_File^ Magnetic Tape) Table Require men ts 

T¥PEFLE=tfORK requires 48 bytes per work file. 
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rne table requirements for INPUT and OUTPUT files are: 



r t t 

TYPEFLE= | RECFORM=| Basic 
] J Size 

j | Without 

J | STDLABELS 



T T 

ERROPT, 
ERREXT 
(Witnout 
STDLABELS) 



T 1 

Basic | ERROPT, 
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With j (Witn 
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FIXBLK 
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| UNDEF | 

h + 
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* Included in basic Size of Module. 
Figure 12-1. DTFMT -- Table Requirements 
MTMOD {.Vlaqnetic Tape Module) 

r 



EBCDIC MAGNETIC TAPc MODULE 
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INDEPENDENT OPTIONS 



| R£CFORM= 
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| BASIC 
! MODULE 
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Figure 12-2. MTMOD -- Storage Requirements (Part 1 of 3) 
Notes : 

1. Only one module is required for processing all files having a common RECFORM. mis 
module can be generated with the options charted above. To determine the size of the 
module with the options, the number of option bytes specified in tne chart must oe 
added to the basic module. 

2. RDONLY=YES, changes tne size of tne module -50 to +50 bytes. In addition, trie user's 
program must provide a 72-byte save area each time the module is reentered. 
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WORK FILE MODULE 
T T - - 



| | without 

| TYPEFLE=WORK j NOTEPNT 

J. 1 

| witnout ERROPT I 232 
y + 

| witl ERROPT | 280 
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| with ERROPT and | 436 

| ERREXr j 

L J. 



NOTEPlnT : 
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494 



Figure 12-2. MTMOD -- Storage Requirements (Part 2 of 3) 



ASCII MAGNETIC TAPE MODULE 



RECFORM= 
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INDEPENDENT OPTIONS 
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WDRKA= 
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Figure 12-2. MTMOD -- Storage Requirements (Part 3 of 3) 
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Libraries 



:ore Image 



T j 

| Source Statement | 



-+■ 



r T T T 1 

| Transients j Blocks | Macros | Blocks | 
j. f + + j 

12 I 2 I 5 I 722 I 



Q2RE_IMAGE_LIBRARY 

$$ABERRT Error Recovery Procedure 
$$BOOR01 OPEN 

SO!IECE_SrATEMENT_LIBRARy 

Macros 

ElklLDEFINITION 

E.DTFOR 
E. ORMOD 

IMPERATIVE 

E.DSPLY 
E.RDLNE 
E.RESCN 

SIQRA3E_REQUIREMENrS 

Figure 13-1 defines tne storage requirements for ORMOD. 

ORMOD (Optical Reader Module --Except_ for the 3881 Optical Mark Reader) 
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Figure 13-1. OPTICAL READER -- ORMOD Storage Requirements 
DTFOR_ (Define The _, File: 1287 Optical Reader) Table Requirements 

1. RECFORM=FIXUNB requires 136 bytes. 

2. RECFORM=FIXBLK varies as a function of blocking. 

Size = 136 + (16 x blocking factor x number of I/O areas) 

3. RECFORM=UNDEF requires 136 bytes. 
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Sample Problem Summary 

The 1288 sample problem is obtained by retrieving the sample problem for the 1287 journal 
tape mode of operation (Z.CRJT) arid changing the cards with the sequence numoers 1058 and 
1071 as follows: For botn cards change the parameter DEVICE=1287T to DEVICE=1287D. 
(Refer to the listing containing the source statements for the sample test program for 
journal tape processing). Figure 13-2 illustrates the files used by botn problems, and 
Figure 13-3 illustrates the card decks that are punched when the sample problem is 
retrieved. 

The sample problem illustrating document processing for tne 1287 or 1288 optical 
reader (Z.ORDC) reads documents for data input into stn. input area, and then prints tnis 
data on SYSLST. Whenever the 1287 or 1288 document hopper empties, press end-of-file or 
replenish the stack. 

Any approved document type may be used because tne reference mark and data field 
coordinates are entered at program execution time. However, the data field cnosen to be 
read may not exceed six characters in length. 

Figure 13-4 is a sample input document. rne listing contains examples of keyed-in 
error corrections identified by comments. 

Note: tfhen using this program on a 1288, remove the RESCN and DSPLY macro statements 
within sequence numbers 0091 and 0109. 

The sample problem illustrating journal tape mode processing for the 1287 optical 
reader reads undefined records from the 1287 optical reader into a work area from two I/O 
areas, and then prints these records on SYSLST. 

Any journal tape with a maximum record size of 38 characters is suitable for tnis 
sample problem. 

Figure 13-5 is a portion of a sample input journal tape. 



Disk Extent Number 



I" T T T T 1 

| Phase |1 | 2 |3 |4 | 
h + + + + -i 

j Assemble JSYSLNK |SiTS001 | SYS002 |SYS003| 
| Link EditjSYSLNK |SYS001 |- |- | 
[Execute |- |- |- j- | 

L X J. -L L J 



Figure 13-2. OPTICAL READER — Sample Problem 
r t 



Cards Retrieved 



CATALS Z. CRDC 
BKEND Z.ORDC 
Document Mode 
Source Deck (179 
Cards) 
BKEND 

CATALS Z.CRJT 
BKEND Z.ORJT 
Journal Tape Source 
Deck (81 Cards) 
BKEND 



Card Cols. 
73-76 
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T 1 

Card Cols 
77-80 



0001-0179 



1001-1081 



Figure 13-3. OPTICAL READER — Sample Problem Card Deck 
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S£SLO3_0ateut: 

// JOB OPTICAL READER SAMPLE PROBLEM 

EOJ OPTICAL 

// PAUSE END OF OPTICAL READER SAMPLE PROBLEM 



SISLST_Out£ut_Sum[na.rY 

• Job control cards 

• External symbol dictionary 

• Source program listing 

• Relocation dictionary 

• Linkage editor input diagnostics 

• Linkage editor storage map 

• List of fields read from: 

for document sample problem, or 
for journal tape sample problem. 









Hi — 


/23Y56 78 


L 






tar 


• 
J 










,„„ 


« 


05 2M-680 357 9 8 

01 36925 4-68 1 

02 13579 205 2* 
01 725»f6 763 63 

03 56384- 920 57 
01 ¥2679 f 31 76 
Of 66392 1 1733 

f MM! 

Ml 

13579 

021057 """ 








2500 

4-18 
3M-9 
J 29 

995 
3960 














8 
8 

i 


578 
1 50 
728 




Figure 13-4. OPTICAL READER — Sample 

Input Document for Document 
Mode Processing 
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012 


345b 


7ARC 


iea 


45b? 


AIDS 


234 


5b?A 


R01T 


345 


b7AR 


012N 


45b 


7AR0 


123$ 


5k? 


AR01 


234 X 


b?A 


R012 


345C 


?ar 


0123 


4SbT 


ARO 


1234 


5b?Z 


R01 


2345 


b?A/ 


012 


345b 


7ARC 


183 


45b? 


AROS 


234 


Sb?A 


R01T 


345 


b?AR 


D12N 


45b 


7AR0 


123S 


5b? 


AR01 


234X 


b?A 


R012 


345C 


7AR 


0123 


45bT 


610 


1234 


5b?Z 


roi 


2345 


b?A/ 


012 


345b 


7ARC 


123 


45b? 


AROS 


234 


5b?A 


R01T 


345 


b?AR 


012N 


4Sli 


7AR0 


123S 


Sb? 


AR01 


234X 


b?A 


9012 


34SC 


7AR 


0123 


45bT 


ARO 


123 4 


5b?Z 


901 


2345 


b?A/ 



Figure 13-5. OPTICAL READER — Sample 

Input for Journal Tape Mode 
Processing 
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r 1 

| Libraries | 

|. T ., 

| Core Image | Source Statement | 
j. T + _ T .j 

| Transients | Blocks | Macros | Blocks ( 
,. + + + ^ 

| 2 | 2 | 6 | 382 | 

L 1 J. J J 



?QEE_I^3E_LIBRARY 

5£§Qsients 

$$A.BER&N Error Recovery Procedure 
$$BOOR01 OPEN 

SOURCE_Sr^TEMENT_LIBRARY 

DRMOD_^3 8 8 6_0£tical_Cha^acter_Rea3er_Module^ 

Macros 

1. Format Definition 

E. DFR 

E.DLINT 

E. DLINTIN (Inner macro, used only by the DLIiMT macro) 

2 • Fi ls_Def i niti on 

E.DIFDR 
E.DRMOD 

3 • £2£§.Es*ti ve 

E.SEIDEV 

S_rORA3E_RE2UIREMENTS 

DRMOD: 

(Basic Size = 443 bytes) 

Basic + RDONLY=395 

Basic + SETDEV=773 

Basic + RDONLy + SETDEV=773 

DTFDR Table Requirements 
Size = 124+BLKSIZE+FRSIZE 
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r 1 

| Libraries j 

j. T .| 

| Core Image j Source Statement | 
h T x T j 

| Transients | Blocks | Macros | Blocks | 
y x x x H 

| 3 | 4 | 2 | 593 | 

L X X X J 



C0RE_IMA3E_LIBRARy 

transients 

$$ABERRQ Error Recovery Procedure (ERP) 

$$&BERRV ERP 

$$BERPTP ERP - 1018 with error correction feature 

SOURCE STATEMENT LIBRARY 

Fil e Definition M acros 

E.DTFPT 
E.PIMOD 

S10RA3E_REQtJi.REMENrS 

Dr_FPr_(.Def ine_rhe_Filej Pager Tape) _ Table Requirements 

INPUT_FILE 

The possible table specifications and sizes are: 

1. No translations, no shifts, and no deletes require 72 bytes, 

2. TRkNS=name with no snifts and no deletes requires 76 bytes. 

3. TRANS=name, SCAN=name, RECFOR?4=FIX0NB require 110 bytes. 

4. TRANS=name, SC&N=name, RECFOR.VI=UNDEF require 94 bytes. 

OUlP[Jr_FILE 

rne possible table specifications and sizes are: 

1. No shifts require 69 bytes. 

2. Shifts require 83 bytes. 
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E™0JD_£Paj3er_Tage_ModujLe)_ 

The module specifications and sizes are specified in Figure 15-1. 

1 













iupor 




1 


OUTPUT 










I- 
l 


2671 


i 

1 

I 


1017 


-+- 

1 
I 


1018 










1 




1 




1 




1. 


No parameters specified 


(no 






244 


I 


288 


1 






translation, no shifts and 


no 






1 




1 






deletes) 






l 




1 
1 




1 
1 












l 




1 




1 




2. 


rRA.NS=YES with no shifts 
no deletes 


an 


d 


l 


310 


1 

1 
I 


354 


1 

1 
I 












1 




1 




1 




3. 


TR?lNS=YES f SCkN=YES, 
RECFORM=FIXUNB 






i 


536 


1 

1 
-J- 


570 


1 

1 
I 












1 




1 




1 




4. 


rRANS=YES, SC&N=YES, 
RECFORM=UNDEF 






i 


436 


1 

1 
I 


474 


1 

1 
1 












1 




1 




1 




5. 


lSJo shifts 






l 




1 
_ i 




1 

I 


352 










1 




1 




l 




6. 


Shifts 










1 




1 


570 



L i2te: If module 2 is used, all records require translation. 
Figure 15-1. PTMOD -- Storage Requirements 
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j Libraries 


| Core Ima 


T 

ge I 

1 


Source 


Statement 


1" T~ 

| Transients | 

h +- 

1 30 J 

L X 


T 

Blocks | 

x_ 

30 | 

_ _ X 


Macros 
11 


"T 
I 
- + - 

I 

_X 


Blocks 
6,848 



SQRE_I^3E_LIBRARY 

i!^i.[l§isQts 
I $$B0SDB1 

$$bosdci 

$$BOSDC2 

$$B0SDC3 

$$B0SDEtf 

$$B0SDI1 

$$B0SDI2 

$$B0SDI3 

$$B0SDIU 

$$B0SDI5 

$$BOSD01 

$$BOSD02 

$$BOSD03 

$$BOSD04 

$$BOSD05 

$$BOSD06 

$$B0SD07 

$$B0SD08 

$$B0SD09 

$$BOSDRP 
| $$B0SDR£ 

$$BOSDRS 

$$B0SDW1 

$$BOSDtf2 

$$BOSDW3 

$$BOSD00 

$$BOSD01 

$$BOSD02 
| $$BOSD03 

$$B02321 

SOURCE STATEMENT LIBRARY 

File _ Def initionMacros 

E.DTFSD 

E.SDMODFI 

E.SDMODFO 

E.SDMODFU 

E.SDMODUI 

E.SDMODUO 

E. SDMODCJU 

E.SDMODVI 

E.SDMODVO 

E.SDMODVQ 

E.SDMODW 
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STOR A3 ^REQUIREMENTS 

Figures 16-1, 16-2, arid 16-3 -specify trie storage required by DTFSD and SDlYLOD, 

DTFSD_(_Define_rhe_Filej_ Sequent ial_D AS 0)_ 



RECFORYl= 



TYPEFLE 



T T 

irtpur | output | *~ork 
T ^ h T 

with | without | | with | without 



UPDATE | UPDATE 



+ ■ 



+ - 



UPDATE | UPDATE 



CONTROL 
YES 



FIXBLK 

or 

FIXUNB 

j. 

VARBLK 
or 

VARUNB 

SPNBLK 

or 
SPNUNB 



176 



| 152 
■+ 



160 



152 



152 



+ 24 



192 
240 



| 152 
| 188 



170 
| 

244 






+ 24 
+ 24 



I" 



.x x x x x. 

| 152 | 162 1 152 | 152 | 

.X X X X X. 



j UNDEF | 192 

L X 



+ 24 



Figure 16-1. DTFSD -- Storage Requirements 

Support for RPS requires 256 bytes for e^ch open DTFSD to be available in the GEIVIS area 
of the partition. This area is allocatea during open; it is used to generate RPS cnannel 
programs. 
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SDMOD (SEQUENTIAL DASD MODULE) 



I" 

I c 

H 

SDMODFO 
SDMODFU 



Module Name 



Basic Module 



TRUNCS 



CONTROL 



ER.ROPT | HOLD 



ERRCPT 
ERREXT 



RECFORM=SPNBLK | 
RECFORM=SPNUNB | 



SDMODFI 



462 



+ 80 



+ 28 



-h 



+ 144 | 



+ 228 



546 
798 



+ 136 



+ 28 



+ 28 



h- 

I c 

I" 

I c 

!-- 

K 

SDMODVO 
SDMODVU 



+ 64 | 
+164 | +96 



+ 200 
+ 252 



■+- 



+- 



SDMODUI 



533 



+ 28 



+ 100 



+ 171 



SDMODUO 



653 



+ 28 



+ 68 | 
— +- 



+ 116 



SDMODUU 



941 



+ 28 



+148 | +40 



+ 248 



SDMODVI 



729 



+ 28 



+ 104 



+ 1! 



300-400 



■+- 



-+ + 

+ 68 | 
+ + 

+176 | +76 



1045 
1086 



+ 28 

+ 

+ 28 



+ 120 
+ 296 






1050-1150 
1500 



-+■ 



■+ 



+148 1 +10 | +246 
x x J. 



SDMODW | 572 | | +22 
L x x x 

*The HOLD function does not apply to these modules. 
Notes: 

1. For SDMODW, NOTEPNT=YES requires 206 additional bytes: NOTEPNT=POINTRW requires 144 
additional bytes, UPDATE=YES requires 40 additional bytes. 

2. RDONLY=YES changes the size of the module -50 to +50 bytes. In addition, the user's 
program must provide a 72-byte save area each time the module is reentered. 

Figure 16-2. SDMOD — Storage Requirements - Non-RPS Version Module Sizes 



1394 
SDMODUI 



Module Name 
SDMODFI 
SDMODFO 
SDMODFU 



4- 



SDMODUO 
SDMODUU 
SDMODVI 
SDMODVO 
SDMODVU 
SDMODW 



Basic Module 
884 
1020 



908 
1050 
1496 

986 
1522 
1762 
1934 



TRUNCS 
+ 174 
+ 142 
+ 142 



T 1 

RECFORM=SPNBLK 
RECFORM=SPNUNB 



-+" 



+ 436 
+ 1224 
+ 1524 



Note: Each RPS version of the module supports all other valid options. 
Figure 16-3. SDMOD — Storage Requirements - RPS Version Module Sizes 
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Module 17: VSAM - 5745-SC-VSM 



Module Outline 



general considerations 257 

VSAM data management modules.. 257 

core image library 257 

transients 257 

phases 257 

relocatable library 257 

modules 2 57 

link-edit statements 258 

source statement library 258 

macros (edited) 258 

loading VSAM and EPS phases into the 

SVA 2 59 

ISAM interface program 261 

core image library 261 

transient 261 

phases 262 

relocatable library 262 

modules 262 

link-edit statements 262 

access method services 262 

core image library 262 

phases 262 

relocatable library 262 

modules 26 3 

link-edit statements 263 

storage requirements 263 

real storage for VSAM 263 

virtual storage 265 
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General Considerations 



N o n-SVA-eligi bl egnases : 



mis section discusses the three elements 
necessary to run VSAM: VSAM itself, its 
utilities (Access Method Services), and the 
ISAM Interface program. VSAM may run by 
itself or with either or both of the other 
two programs. 



IKQVDCN 

IKQVDU 

IKQVDUMP 

IKQVEDA 

IK2VLASF 

IKQV7RI 

IKQVSCTAr 

RELOCATABLE LIBRARY 



VSAM Data Management Modules 

^5RI_I^A5E_liIBRARy; 

r t 1 

I Iransi ents ( 15 | 
| Blocks | 17 | 
^ x .] 

| Phases j 31 j 

| Blocks | 321 | 

L X J 

l£§.Qsients 
$$BACLOS 

$$bc:lc:ra 

$$BCV3AM 
$$BCVS02 
$$BCVS03 
$$BCVS04 
$$BENDQB 
S$BJIBFF 
$$BJIB00 
$$BODADE 
$$BODADS 
$$BOVSAM 
$$BOVS01 
$$BOVS03 
$$BrCLOS 

SVA-eli^ibleghases (see section "Loading 
VSAM Phases into the SVA") 

IKQVBEP 

IKQVCAr 

IKQ7CLC 

IKQVCLOC 

IK2VCL0S 

IKQVCLOV 

IKQVDNT 

IK2VDRP 

IKQVDrPE 

IKQVEDX 

IKQVEOtf 

IK2VGEN 

IKQVJIBS 

IKQVLAB 

IKQVLASM 

IKQVMS3 

IKQVNEX 

IK2VOPEN 

IKQVPBF 

IKQVRBA 

IKQVRtt 

IK2VSTM 

IK2VTMS 



r t t 

| Numoer of Modules (Number of Blocks | 
y f ^ 

I I 164 I 1,756 | 

1 L X J 

Modules 

$$BACLOS 

$$BCLCRA 
$$BCVSAM 

$$bc:vs02 

$$BCV303 
$$BCVS04 
| $$BENDQB 
$$BJIBFF 
$$BJIB00 
$$BODADE 
$$BODADS 
$$BOVSAM 
$$BOVS01 
$$BOVS03 
$$BrCLOS 
IGGOCLAB 
IGGOCLAC 
IG30CLAD 
IGGOCLAE 
IGGOCLAF 
IGGOCLAG 
IGGOCLAti 
IGGOCLAJ 
IGGOCLAK 
IGGOCLAL 
IGGOCLAN 
IGGOCLAP 
IGG0CLA2 
IGGOCLAR 
IGGOCLAS 
IGGOCLAT 
IGGOCLAU 
IGGOCLAV 
IGGOCLAtf 
IGGOCLAX 
IGGOCLA* 
IGGOCLAZ 
IGG0CLA6 
IG30CLA7 
IGG0CLA8 
IGGOCLBA 
IGGOCLBB 
IG30CLB3 
IGGOCLBD 
IGGOCLBE 
IGGOCLBF 
IGG0CLB3 
IGGOCLBH 
IGGOCLBL 
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IG30CLBXI 

I330CLBN 

I330CLBQ 

I330CLBR 

I330CLB5 

I330CLBT 

I3G0CLBU 

I330CLBW 

I330CLBX 

I330CLBY 

IG30CLB8 

IG30CLCA 

IGSOCLCB 

IG30CLCD 

IG30CLC3 

I330CLCL 

IGGOCLCO 

IGGOCLCP 

I3GOCLCR 

IGGOCLCS 

ISGOCLCX 

IGGOCLCY 

IGG0CLC9 

IKQMX 

IKQALLOO 

IK2BFA 

IK2BFB 

IKQBFC 

IK2BLD 

IK2BRP 

IK2CAS 

IK2CIR 

IK2CIS 

IK2CLC?Vr 

IK2CLEAN 

IK2CLMLK 

IK2CLOCL 

IKQCLOVY 

IK2CLO 

IK2COV00 

IK2DCN 

IKQDNr 

IK2DRP 

IK2DUMP 

IK2DUMPC 

IK2EDX 

IKQEOV 

IK2ERH 

IK2ERK 

IK23EN 

IK2GNX 

IK2GPT 

IK2INT 

IK2IOA 

IK2IOB 

IK2IXE 

IK2IXF 

IK2IXS 

IK2JIB5M 

IK2JRN 

IK2KRD 

IK2LAB 

IK2LASFT 

IK2LA.SMD 

IK2LCD 

IK2LCN 

IK2LCP 

IK2MDY 



IKQfcJCA 

IKQNEX 

IKQOCMS3 

IKQOPN 

IKQOPNAI 

IKgOPNCT 

IKQOPNDO 

IKQOPNHC 

IK20PNNC 

IKQOPNOV 

IKCOPNRD 

IKQOPNRP 

IKQOPNU3 

IKQOPNUS 

IKQPBF 

IKQPFO 

IKQPOP00 

IKQRBA 

IKQRCL 

IKQRDSOO 

IK2REN00 

IKQRQk 

IKQRQB 

IKQRQC 

IKQRRP 

IKQRW 

IK2SCAT 

IKQ3CN 

IKQSCROO 

IKQSFT 

IKQSPM 

IKQSRG 

IKQSRT 

IKQSRU 

IKQSTM 

IKQTMSD 

IKQTMSF 

IKQUPD 

IKQUPG 

IKQVDIPE 

IKQVEDA 

IKQVFY 

IKQVRT 

IKQVSM 

IKQVSMLK 

IKQVTCOO 

IK2WDS00 

Link-Edit State me n t s 
// OPTION CA.T&L 

INCLUDE IK2VSyiLK 
// EXEC LNKEDT 

Ignore notice "CONTROL SECTIONS OP ZEBO 
LENGTH IN INPUT" given by the linkage 
editor at the end of the partition storage 
map. 

SOURCE STATEMENT LIBRARY 

r t 1 

| Number of Macros | Number of Blocks | 
Y + _ ., 

I I 26 | 1,602 | 

I L X J 

Macros^jEdited) 
A.CB* 
BLDVRP 
| DEOB 
DLVRP 
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EWDREQ 
| ENQB 

ERASE 

EXLST* 

GENCB* 
I IKQACB* 

IKQACB3 

IKQCBl* 

IK2CB2* 

IK2ERMAC* 

IKQEXL3 

IIKQEXLST* 
IKQEPL* 
IKQRPL3 
MODCB* 
POINT 
RPL* 
SHOtfCAT 
SHOWCB* 
TCLOSE 
TESTCB* 
tfRTBFR 
| *These macros are also required by VTAM. 

LOADING VSAM AND RPS PHASES INTO THE SVA 
The system procedure library contains 
procedures VSAMSVA and VSAMEPS to load 
IBM-supplied phases into the SVA. 

• Procedure VSAMSVA loads a set of 
selected system phases plus VSAM phases 
- but no EPS phases. 

• Procedure VSAMRPS loads a set of 
selected system phases plus VSAM and 
EPS phases. 

Loading trie SVA-eligiole VSAM pnases into 
trie SVA offers the following advantages: 

• you save virtual and real storage space 
in tne partitions if the phases are to 
be snared between several partitions; 

• you save load time per job step. The 
pnases always remain in the SVA; even 
the IPL procedure may use a warm start 
copy; 

• the phases are protected against 
descruction by user program errors. 

Note: The SVA-GETVIS area is not used for 
VSAM. 

Procedure VSAMSVA consists of statements 
and phase names as follows: 

SET SDL=CREArE 

$$BCLOSE 

$$BCL0S2 

$$BCL0S3 

$$BCLOS4 

$$BEOJ 

$$BE0JS1 

$$BEOJ4 

$$BEOJ7 

$$BOCP01 

$$BOCP03 



$$BOFLPT 

$$BOPEN 

$$BOPEND 

$$BOPENR 

$$BOPEN0 

$$BOPENl 

$$B0PEN3 

$$B0PEN4 

$$B0PEN5 

$$B0PEN6 

$$BOPISN 

$$B0SDC1 

$$B0SDC3 

$$B0SDI1 

$$B0SDI2 

$$B0SDI4 

$$B0SD01 

$$B0SD02 

$$B0SD03 

$$B0SD04 

$$B0SD08 

$$B0SD09 

$$B0SDW1 

$$B0SDtf2 

$$BOSD00 

$$BOSD01 

$$BOSD02 

$$BOSD03 

$$BOSD04 

$$BOSD05 

S$BOSD06 

$$BOSIGN 

$$BSEIL 

$$BSETLl 

$$BSETL2 

$JOBCrLA 

$JOBCTLE 

$JOBCTLN 

$JOBACCI # SVA 

$JOBEXir,SVA 

$LIBSTAT,SVA 

$MAINDIR,SVA 

$$BACLOS The following are VSAM 

$$BCLCRA phases 

$$BCVSAM 

$$BCVS02 

$$BCVS03 

$$BJIBFF 

$$BJIB00 

$$BODADE 

$$BODADS 

$$BOVSAM 

$$BOVS01 

$$BOVS03 

$$BTCLOS 

IKQVBRP,SVA 

IKQVCAI,3VA 

IKQVCLC,SVA 

IKQVCL0C,3VA 

IKQVCLOS,SVA 

IKQVCL0V,3VA 

IKQVDCN 

IK2VDNT,SVA 

IKQVDRP,SVA 

IKQVDrPE,3VA 

IKQVDUMP 

IKQVEDX,SVA 

IKQVEOV,SVA 
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IK0.VGEl\1,»VA 

IKQVJIBS,SVA 

IKQVLAB,dVA 

IKQVLASF 

IKQVLASM,3VA 

IK2VMSG,SVA 

IKQVNEX,SVA 

IK2V0PEN,SVA 

IK2VPBF,SVA 

IK2VRBA,SVA 

IEQVRM,SVA 

IK2VRT 

IK2VSCAI 

IK2VSTM,SVA 

IKQVTMS, SVA 

/* 

/ + 

Procedure VSAMBPS consists of the 
transients, phases, and statements given 
for VSAMSVA (excluding the /* and /+) plus 
the following: 

IJGCYCMB,SVA 

IJGCYCWB,SVA 

IJGFHCMB,SVA 

IJGFRCWB,SVA 

IJGFXCMB,SVA 

IJGFXCKB,SVA 

IJGP¥CWB,SVA 

IJGQSCWB,SYA 

XJGQXCWB,SVA 

IJGBYCWB,SVA 

IJGSYCHB,SVA 

IJGTWNCT,SVA 

IJGOHCHB,SVA 

IJGOXCWB,SVA 

IJGVMCWB,SVA 

IJGVXCHB,S¥A 

IJHAVBBF,SVA 

IJHAVBBS,SVA 

IJHAVBCF,SVA 

IJHAVBCS,SVA 

IJHAVGBF,SVA 

IJHAVGBS,SVA 

IJHAVGCF,SVA 

IJHAVGCS,SVA 

IJHZXGZS,SVA 

IJIBWEHW,SVA 

IJIFWEH» r SVA 

IJ1S«EHW,SVA 

IJIVSEHN,SVA 

IJJCVAIN,SVA 

IJJCVDV,SVA 

IJJCVDO,SVA 

IJJFVBIC,SVA 

IJJFVIIC,SVA 

/* 

/♦ 



L i2te: rae $$B-transients and the $-pnases 
are not part of VSAM and DOS/VS only 
includes their names in the system 
directory list (SDL)*. However, as 
building the SDL can only be done 
concurrently with loading the SVA, the 
names of these transients and phases are 
also included in procedure VSAMSVA. If 
VSAM is not to run in the SVA, you can use 
the IBM- supplied procedure SDL to include 
the non-VSAM phases and transients in the 
system directory list. 



* SJOBEXIT, SLIBSTAT, and SMAINDIR are 
loaded into the SVA to improve 
performance. 

* $JOBACCT should be included if using trie 
IBM-supplied default. 

The SVA-eligible VSAM phases can oe divided 
into two distinct groups, tnat is tne root 
phases that are to be loaded whenever you 
want to use VSAM at all, and the optional 
phases that are loaded only if certain 
conditions are encountered in VSAM 
processing. rne latter phases remain in 
virtual storage until the job step is 
finished. 



VSAM Root Phaser 





j j Size 


Function 


] Pnase | (bytes) 




.__| 1 


Record management 


(IK2VRM | 51,3 30 


routines 


i 1 


Open routines 


| IfQVOPEN'l 22,600 


Close routines 


|J.KQVCLOS| 2,800 


Label processing 


|IKQVLAB j 2,200 


routines 


i 1 


Catalog routines 


jIKQVCAT |16 3,9 00 


File table routines 


•IKQVLASMj 1,200 


Message routine 


|IKQVMSG | 2,100 



h + 1 j 

I Total | i 246 , 150 | 

L J. X J 



Wnen certain other conditions are 
encountered in VSAM processing, other 
phases will be loaded into the virtual 
address area. These phases remain in the 
virtual address area with the originally 
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loaded phases until the joo step is enaed. 
The following additional phases can oe 
loaded; 



If you do not need all tne optional pnases, 
you can save SVA space by using your own 
procedure that snould have the following 
format: 



Condition 


Phase 


Size 
(oytes) 

L 


_. i 
I/O forced to completion 
(during Close, for 
example) 


r 1 
IKQVPBF 


r 


700 


snare option 4 used and 
(1) a control 3rea must 
be split or (2) tne file 
is extended 


IKQVRBA 


1, 


100 


A new extent is needed 
when file is extended 


1K2VNBX 


3, 


700 


3ENCB macro is used by 
tne processing proqram 


1K2V3C.W 


2, 


400 


MODCB, SHOtfCR, or TESTCB 
macro is used oy the 
processing program 


IKQVIMS 


9, 


600 


A non-contiguous range 
of RBAs is encountered 


IK2VEDX 


2, 


500 


Non-VSAM file entry in 
VSAM catalog is 
processed 


IKQVDNT 




300 


A new volume must be 
mounted 


IK2VE0V 


1, 


100 


DASD file protection 
option is included in 
DOS/VS 


IKQVJIBS 


1. 


000 


VSAM Close or Record 
Manageaient routines must 
update the VSAM catalog 


IK2VCLC 


2, 


500 


Device type must oe 
determined 


1K2VDTPE 




600 


Alternate index struc- 
ture must oe closed 


IK2VCL0V 




600 


Control blocks for 
alternate index struc- 
ture must be released 


IK2VCLOC 




500 


Build VSAM resource pool 


IK2VBRP 


2, 


048 


Delete VSAM resource 
pool 


IKQVDRB 




650 


SriOWCAT 


IK2VSCAT 


1, 


500 


VSAM storage manager 
control block 
reallocation 


IK2VSTM 


2, 


000 



// SET SVA=(. . .K,0K) 
// SET SDL=CREATE 

(non-VSAM phase names) 

Ctne 7 VSAM root pnase names), SVA 

(the optional VSAM phase names you will 

require) , SVA. 
/* 
/+ 



The size of the SVA can be computed as 
follows: 

• 34 bytes for each SDL entry (tne maximum 
number of entries is 934, which take up 
32K bytes) . 

• 2K bytes for the SVA directory. 

• 12K bytes if you want to load $J0BEXIr 
and $MAINDIR into the SVh. 

• 221. 1Y. bytes for the VSAM root phases.* 

• The total size of the optional VSAM 
phases you selected.* 

• Totalling the sizes of the VSAM root 
phases and of the optional phases does 
not give you tne exact size of tne SVA, 
as these pages are normally loaded on 
page boundaries, witn tne exception of 
small pnases, two or more of wnich fit a 
single page. 

Also, since the pnases are entered in 
alphabetical sequence, what extra space 
is required depends on which optional 
phases you include in your procedure. If 
you include all of the optional phases, 
add 10K bytes to the total size of the 
root phases and the optional phases. For 
the same reasons, the size of tne SVA in 
procedure VSAMSVA is set to 302K bytes. 



ISAM Interface Program 



|. x r .| 



J Total 

L 



32,798| 
: j 



£2R£_l?5£GE_LIBRAR3f 

r t 1 

I Ellipses | 5 | 

| Blocks | 9 | 

l x J 

Transient 
$$BOCISC 
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Phases 

IIPCLOSE 

IIPOPEN 

IIPPROC 

IIP&MDTF 



RELOC^T^BLE_LIbR2\RY 

r t t 

j Modules | 7 | 

| Blocks | 44 | 

L X J 

Modules 

IIPBMROO 
IIPCLSOO 
IIPIIPOO 
IIPOPN00 
IIPPRCPR 
IIPPRCMR 
IIPAMIOO 

Link-Edit_State_2ents. 

// OPTION CATAL 

INCLUDE IIPIIPOO 
// EXEC LNKEDT 



Access Method Services 



CQRE_IMAGE_LIBRARY 

r t t 

| Phases 1 81 | 

| Blocks | 496 | 

L X J 

Phases 

IDCAL01 

IDCAMS 

IDCBI01 

IDCCDA.L 

IDCCDBI 

IDCCDDE 

IDCCDDL 

IDCCDLC 

IDCCDLR 

IDCCDMP 

IDCCDPM 

IDCCDPR 

IDCCDRC 

IDCCDRM 

IDCCDRP 

IDCCDRS 

IDCCDVY 

IDCCDXP 

IDCDB01 

IDCDB02 

IDCDE01 

IDCDI01 

IDCDI02 



IDCDI03 

IDCDI04 

IDCDI05 

IDCDI06 

IDCDI07 

IDCDI08 

IDCDI09 

IDCDI10 

IDCDI11 

IDCDI12 

IDCDI13 

IDCDI14 

IDCDI15 

IDCDI20 

IDCDL01 

IDCEX02 

IDCEX03 

IDCIO02 

IDCIO03 

IDCLC01 

IDCLR01 

IDCMP01 

IDCPMOl 

IDCPR01 

IDCRC01 

IDCRIKI 

IDCRILr 

IDCRI01 

IDCRM01 

IDCRPOl 

IDCRS01 

IDCSA04 

IDCSA05 

IDCTP04 

IDCrP05 

IDCIP06 

IDCISALO 

IDCTSBIO 

IDCTSDEO 

IDCTSDLO 

IDCTSEXO 

IDCTSIOO 

iocrsLco 

IDCTSLC1 
IDCTSLR0 
IDCTSLR1 
IDCTSMP0 
IDCTSPP6 
IDCTSPR0 
IDCTSR20 
IDCTSRIO 
IDCTSRS0 
IDCTSTPO 
IDCTSTP1 

iDcrscjvo 

IDCTSXPO 

IDCVY01 

IDCXPOl 



RELOCATABLE LIBRARY 



r t 1 

| Number of Modules | Number of Blocks | 
h x ^ 

J 104 | 2,275 | 

l x J 
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Modules 

IDCAL01 

IDCBI01 

IDCCDAL 

IDCCDBI 

IDCCDDE 

IDCCDDL 

IDCCDLC 

IDCCDLR 

IDC"DMP 

IDCCDPM 

IDCCDPR 

IDCCDRC 

IDCCDRM 

IDCCDRP 

IDCCDRS 

IDCCDVY 

IDCCDXP 

IDCCMZ1 

IDCCMZ2 

IDCDB01 

IDCDB02 

IDCDE01 

IDCDE02 

IDCDE03 

IDCDIOl 

IDCDI02 

IDCDI03 

IDCDI04 

IDCDI05 

IDCDI06 

IDCDI07 

IDCDI08 

IDCDI09 

IDCDIIO 

IDCDI11 

IDCDI12 

IDCDI13 

IDCDI14 

IDCDI15 

IDCDI20 

IDCDL01 

IDCEX01 

IDCEX02 

IDCEX03 

IDCIOOl 

IDCIO02 

IDCIO03 

IDCLCOl 

IDCLC02 

IDCLR01 

IDCLR02 

IDCMPOl 

IDCPMOl 

IDCPROl 

IDCRCOl 

IDCRC02 

IDCRC03 

IDCRC04 

IDCRIKT 

IDCRILT 

IDCRI01 

IDCRI02 

IDCRI03 

IDCRMOl 

IDCRPOl 

IDCKSOl 



IDCRS02 

IDCRS03 

IDCRS04 

IDCRS05 

IDCRS06 

IDCRS07 

IDCSAOl 

IDCSA02 

IDCSA03 

IDCSA04 

IDCSA05 

IDCSA08 

IDCTPOl 

IDCTPOU 

IDCTP05 

IDCTP06 

IDCTSALO 

IDCTSBIO 

IDCTSDEO 

IDCTSDLO 

IDCTSEXO 

IDCTSIOO 

IDCTSLCO 

IDCTSLC1 

IDCTSLRO 

IDCTSLR1 

IDCTSiyiPO 

IDCTSPRO 

IDCTSRCO 

IDCTSRIO 

IDCTSRSO 

IDCTSTPO 

IDCTSTP1 

IDCTSTP6 

IDCTSUVO 

IDCTSXPO 

IDCVYOl 

IDCXPOl 

Link-E dit S tatements 

// OPTION CATAL 

INCLUDE IDCCMZ1 

// EXEC LNKEDT 

// OPTION CATAL 

INCLUDE IDCCMZ2 

// EXEC LNKEDT 



STORAGE REQUIREMENTS 
Real S tora ge for VSAM 



To avoid excessive paging, an amount of 
real storage should be available in the 
page pool which approximately matches the 
VSAM working set. 

The working set requirements for 
processing a VSAM file are as follows: 

• For frequently used modules of VSAM 
record management (phase IKQVRM) : 11 
pages per partition. During loading or 
extension of a file, or whenever many 
control interval splits take place, up 
to 13 pages may be needed. 
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For (external and internal) control 
blocks: 1 page (minimum) per file. 



• For tne channel program area usea t>y 
VSAM: 1 page per file. 



VSAM buffers - an amount of storage tnat 
depends on the control interval size and 
the number of Duffers used for the file. 



Minimum Working Se t for a Single Fjle 



Provided all tne conditions listed in 
Figure 17-1 are met, the minimum working 
set size for a single VSAM key-seguenced, 
or entry-sequenced , or relative-record file 
can be calculated as follows: 

- IKQVRM 11 pages* 

Control blocks 1 page 

Channel program area _1 _page 

= 13 pages 

+ Buffers 

* or 13 pages when the file is loaded or 

extended. 



Tne conditions for using a minimum 
working set are: 

The file must not nave key ranges 
associated with it. 

The file m»:st not nave more than one 
extent for data. 

Tne file must not nave 
SHAREOPTlOdS(U) . The lengtn of tne 
key field is assumed to be four bytes. 

The file must not have more than one 
extent for the seguence set and for 
the higher-level index. 

The number of data buffers must be 2; 
the number of index buffers must oe 1 
if the file is a key-seguenced file. 

Tne ACB and RPL must be created via 
GENCB, leaving the space allocation up| 
to VSAM and in the seguence 

GENCB ACB 
GENCB RPL 

The file must be opened for one string, 
only (STRNC=1). 

L J 

Figure 17-1. Minimum Working Set 
Conditions 



For eacn additional file in the partition 
the following has to be added to the 
minimum working set size: 



1 page for control blocks (miminum) 
1 page for the channel program area 
n pages for buffers 



jgrkifll-.- Se t_f or Alternate Inde x Processing 

If an alternate index is processed as an 
end-use object, that is, without its 
related base cluster, it is treated as a 
key-seguenced file and, therefore, has the 
same working set requirements as a 
key-seguenced file. 

If a path is establisned between an 
alternate index and its oase cluster, the 
working set requirements for processing tne 
base cluster via this alternate-index path 
(path entry) are as follows: 

• For frequently used modules of VSAXI 
record management (phase IKQVR.Vi) : 11 
pages per partition. 

• For external and internal blocks: 

1 page (minimum) for the path entry 

2 page (minimum) for the base cluster 
1 page (minimum) for each alternate 

index in the upgrade set in 
addition to the path entry. 

• For the channel program areas: 

1 page for the patn entry 
1 page for the base cluster 
1 page for the upgrade set 

• VSAM buffers for: 



the base cluster 
ttie alternate index pa 
for an UPDATE path onl 
a minimum of two data 
index buffer for any a 
index(es) in the upgra 
addition to the altern 
the patn entry) . Note 
alternate indexes of a 
(except that of the pa 
a common set of buffer 
tnat of the largest bu 
specified. 



tn (path entry) 

Y- 

buffers and one 
lternate 
de set (in 
ate index of 

that all tne 
n upgrade set 
th entry) snare 
s whose size is 
f f ers 



Note: For a NOUPDATE patn, the alternate 
indexes wnich are members of the upgrade 
set are not opened. Therefore, only space 
for the path entry and tne base cluster nas 
to be provided. If a base cluster is not 
processed via a path, but has an upgrade 
set assigned to it, space for the base 
cluster itself and for tne upgrade set 
members nas to be provided. 



264 DOS/Vs system Generation 



^2EJSiQ3_Set_f^or_VSAM_Files_Sharinc[_a 
Resource Pool 

VSAM files with MACRF(LSR) in the ACB have 
the following working set requirements: 

• For frequently used modules of VSAM 
record management (phase IK2VRM) : 12 
pages per partition. 

• For external and internal control 
blocks: 1 page (minimum) per file. 

• For the VSAM resource pool: an amount 
of storage that depends on tne 
parameters specified in the BLDVRP 
macro. 

£2£_Access__Metnod_Ser vices: To operate 
efficiently, tne Access Metnod Services 
working set requires approximately 64K 
bytes of real storage. 



Virtual Storage 

For _VSAM: VSAlvi routines reside in pageable 
virtual storage. The recommended 
allocation is 302K bytes in any partition 
in which VSAM will execute, or 302K bytes 
in the SVA. Tnis oasic allocation also 
covers any space requirements for ISAM 
Interface Program (IIP) phases to De loaded 
when a VSAM file is processed Dy an ISAM 
program. (For a more precise storage 
requirement calculation use the table as 
shown in the section "Loading VSAM and RPS 
Phases Into the SVA" . ) 

If VSAM runs in the SVA, a certain 
amount of storage must still De allocated 
to VSAM in the partition for buffers and 
control blocks. Tnis amount can be 
approximated as follows: 

1. Compute for eacn file as a minimum: 

2 x the data control interval size; 

1 x the index control interval size 
(for a key-sequenced file or 
alternate index) ; 

2K bytes for control blocks. 

2. Total the results and add a oasic 
requirement of 30K bytes. 



Note: Control interval size and tne 
minimum amount of buffer space for a file 
are specified when the file is defined. 
you can allocate more than the minimum 



amount of buffer space wnen tne file it; 
processed. Refer to DOS/VS Supervisor and 
I/0_Ma.c_r_2§ for the ACB macro, and to DOS/VS 
§ZStem_2ontrol_Statements for tne DLBL job 
control statement. 

For Access Meth od Services: In addition to 
tne 302K byte basic allocation for VSMVl (or 
302K bytes in the SVA), Access Method 
Services requires up to 450K bytes of 
virtual storage in the partition in wnicn 
it is to run. Unlike VSAM phases, the 
Access Method Services modules cannot be 
loaded into the SVA. 



Tne root modules, comprising 26K bytes, 
are loaded into the virtual address area 
when the user wants to perform any of tne 
following functions. In addition to the 
root modules, the remaining Access Metnoa 
Services substructure modules plus their 
required dynamic work areas are required to 
perform any function. Tne total virtual 
storage requirement for the substructure 
(including the root modules) is 114K. In 
addition, you must provide virtual storage 
for tne specific Access Method Services 
commands to be processed. If you know wnat 
your functional mix is in the job stream, 
you can calculate a more precise virtual 
size from the table below. 



Function 



Size (bytes) 





ALTER 




23, 


000 






BLDINDEX 




24 


000* 






DEFINE 




52, 


000 






DELETE 




10 


000 






EXPORT 




23 


000 






EXPORTRA 




45 


000** 






IMPORT 




29, 


000 






IMPORTRA 




33 


000 






LISTCAT 




42 


000 






LISTCRA 




39, 


000 






PRINT 




8 


000 






REPRO 




17 


000 






RESETCAT 




124, 


000 






VERIFY 


L 


2, 


000 


J 




r 






1 




Total 


1 


471 


000 


I 


1 .. 




i 






J 



* This does not include the storage 

required for sorting records. Refer to 
DOS/ VS_ Ac cess Method Services User's 
Guiae, 3C33-53 82. 

**Tnis does not include the 255,000 bytes 
required for the EXPORTRA command taole. 
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:ORE IWA3E LIBRARY 







1 


Phase 


1 


Blocks 


1 

1 


Assembler 


T " 
1 


19 


" T " 

1 


122 


r 

1 

i ... 


ESERV 


t " 

! 

x _ 


7 


1 


41 



Pnases 

Assembler 

ASSECA 

ASSEDA 

ASSEEA 

ASSEFA 

ASSEGA 

ASSEHA 

ASSEIA 

ASSEJA 

ASSEKA 

ASSELA 

ASSEMA 

ASSEMBLY 

ASSEOA 

ASSEQA 

ASSERA 

ASSERB 

ASSERC 

ASSESA 

ASSETA 



ESERV 

ESERV 

ESERVB 

ESERVD 

ESERVE 

ESERVF 

ESERVG 

ESERVI 



RELOCAIABLE_LIBRARY 

r t t 1 

| | Modules | Blocks j 
j. + 4. ) 

| Assembler | 38 j 609 | 
j. + x 4 

| ESERV | 10 ] 218 | 

L J X J 

Modules 

Assembler 

IPKAA 
IPKAB 
IPKAC 
IPKAD 
IPKAE 
IPKAF 



IPKAG 

IPKAH 

IPKAI 

IPKAJ 

IPKBA 

IPKCA 

IPKCB 

IPKCC 

IPKCD 

IPKDA 

IPKDB 

IPKEA 

IPKFA 

IPK3A 

IPKHA 

IPKIA 

IPKIC 

IPKJA 

IPKKA 

IPKLA 

IPKLINK 

IPKMA 

IPKNA 

IPKOA 

IPKPA 

IPK2A 

IPKRA 

IPKRB 

IPKRC 

IPKSA 

IPKSB 

IPKTA 



Link-Edit Statements 



INCLUDE IPKLINK 
/* 
// EXEC LNKEDr 

ESERV 

IPKESERV 

IPKVA 

IPKVB 

IPKVD 

IPKVE 

IPKVF 

IPKVG 

IPKVI 

IPKVK 

IPKVM 



Link-Edit Statements 



INCLUDE IPKESERV 
/* 
// EXEC LNKEDT 



Note: tfnen link-editing tne ESERV program, 
tne Link-Edit toap will contain one 
unresolved address constant (IPKAB103). 
Tnis is a symbol used in tne Assembler 
only. 
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§OURCE_Sr^TEMENT_LIBR^RY 

r ■ t i 

| Number of | Source Statement j 
| Macros j Library Blocks j 

I. + ^ 

| 2 | 44 | 

L J. J 

Macros 

E.IVP^SLC 
E.IVPASLS 

ii2£lS_£klss 

To determine the number of bytes required 
for the assembler work files, use the 
following formulas: 

S^SOOl: whichever is the larger of 

60(ITXr+SM) 

and 

60(SM+LM) 

SYS0Q2: Whichever is the larger of 

60(ITXT+SM) 

and 

40.ETXT 



SXS003: If option NOXREF is in effect: 

60. OTXT 
If option XREF is in effect: 

loo.orxr 

SJfSLNK: 15.ETXI 

where 

Iixr = Total number of statements on 
SYSIPT. 

OTXT = Total number of statements on 
SYSLST. 

SM = Number of statements in source macro 
definitions. 

ETXT = OTXT minus SM minus number of 
comment statements. 

LM = Number of statements in library 
macro definitions called by the 
program. 



The approximate number of tracks can be 
computed by dividing the number of Dytes by 
6000 for a 2314/2319 file, by 12000 for a 
3330 file, and by 7000 for a 3340 file. 
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PARTITION SIZE 



B-Transients 



The prograa requires a background real 
allocation of 16K bytes, 20K bytes with 
RETAIN active. 



Q2RE_™A3E_LIBRAR£ 

r t 1 

| Phases | Blocks | 
r + 1 ., 

I | OLTEP | 48 | 91 I 
J. + + ., 

| B-Transients j 2 | 2 | 
l x x. J 

Phases 

IJZACEOM 
IJZACOMP 
IJZACONV 
IJZADO00 
IJZADO02 
IJZADO03 
IJZAD007 
IJZADO10 
IJZADOll 
IJZAD016 
IJZAD021 
IJZAD022 
IJZADD24 
IJZAD026 
IJZAD028 
IJZAD031 
IJZAD032 
IJZAD033 
IJZAD035 
IJZAD036 
IJZAD037 
IJZAD039 
IJZADO40 
IJZAD041 
IJZAD042 
IJZAD043 
IJZAD044 
IJZAD045 
IJZAD047 
IJZAD049 
IJZAD052 
IJZAD056 
IJZAD057 
IJZAD062 
IJZAD064 
IJZADO70 
IJZAD071 
IJZAD076 
IJZAD077 
IJZAD078 
IJZAD098 
IJZADOAA 
IJZADOAB 
IJZADOAJ 
IJZADOLD 
IJZADOLT 
IJZAOPUT 
IJZARATA 



$$BOLTEP 
$$BTOLTP 



Note: Trie B-transients are cataloged into 
the core image library along witn trie OLTEP 
component. 



:ONFI3URATION DATA SET 



A CDS (Configuration Data Set) is required 
in the core image library for eacn device 
on the system and one for the CPU. mis is 
tne formula for calculating the block 
requirements : 



^§Yices_on_system_+_l - 
6 



ONLINE TESTS (OLTS) 



library dIocks 



The number of core image library blocks 
required for the OLTs (Online Tests) is 
dependent on the number of types of devices 
on the system, and the number and size of 
the OLTs needed to test these devices. 
This information can be found in the 
writeup that accompanies the OLTs. 



GENERATING THE OLT/CDS LIBRARY 



The PID (Program Information Department) 
supplies a master tape or disk (if tne 
system has no tape drives) to tne Customer 
Engineer. This tape contains OLTSLP, SOSP, 
and OLTs. The EDITDOS function of SOSP 
(Standalone service and Online Test 
Support) is used to create OLT and CDS 
input for the DOS/VS Linkage Editor. This 
input can be created on disk or tape. 



The Job Control statements required to 
link the OLTs and CDSs into the core image 
library are as follows: 



Tape Input 



// JOB 



XXXXXXXX 



assign work files for the Linkage Editor, 
if necessary 

// ASSGN SYSIN,X'CUU' 

where cuu is tne address of the tape drive. 
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Disk_Ingut 

// JOB XXXXXXXX 

assign work files for the Linkage Editor, 

if necessary 

// DLBL IJSYSIN, 'EDITPACK' 
// ASS3N SYSIrt,X'cuu' 

where cuu is the address of the disk drive. 

The OLTs and 2DSs are required to run tests 
under OLTEP. The customer engineer will 
create the library using the specified 
procedure. This procedure is also used to 
add new OLTs and/or CDSs when devices are 
added to the system. 

RELOCAr£BLE_LIBRARX 

r T 1 

1 Mo3ules | Blocks | 

h + j 

I so 1 mo I 

U X J 

Modules 

ijzabook 
ijzaceom 
ijzacomp 
ijzacocw 

IJZADO00 
IJZADO02 
IJZADO03 
IJZADO07 
IJZADO10 
IJZADOll 
IJZAD016 
IJZAD021 
IJZAD022 
IJZAD024 
IJZAD026 



IJZAD028 
IJZAD031 
IJZAD032 
IJZAD033 
IJZAD035 
IJZAD036 
IJZAD037 
IJZAD039 
IJZADO40 
IJZAD041 
IJZAD042 
IJZAD043 
IJZAD044 
IJZADOM5 
IJZAD047 
IJZAD049 
IJZAD052 
IJZAD056 
IJZAD057 
IJZAD062 
IJZAD064 
IJZADO70 
IJZAD071 
IJZAD076 
IJZAD077 
IJZAD078 
IJZADOAA 
IJZADOAB 
IJZADOAJ 
IJZADOLD 
IJZADOLT 
IJZAOLTP 
IJZAOPUr 
IJZARATA 
IJZATOLr 



Link- Edit S tat ements 

INCLUDE IJZABOOK 
// EXEC LNKEDT 

Delete Statem en ts 

DELETR IJZ.ALL 
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Module Outline 



core image library , . 277 

BTAM online terminal test 

pattern phase identification 277 

BTAM transients 278 

relocatable library 278 

modules 279 

concurrent CLTEP 279 

channel program 279 

WTTA subroutine 279 

local 3270 table of command 

codes 2 80 

channel program modules for BSC 280 

ESC tables of special characters 280 

translation tables 2 80 

delete statements 281 

source statement library 281 

macros 282 

storage requirements 283 

DTFBT (define tne file: BTAM) 28? 

table requirements 283 

DTFBTND (-define tne file 

end: BTAM) 285 

DFTRMLST (define the terminal 

list: BTAM) 285 

BTMOD (BTAM logic module) 286 

BTAM data event control clock 

table requirements 2 86 

SCANREQ DECB requirements .. 286 
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Module Index 



B 

BSC table of special characters /.BO 

BTMOD (BTAM logic modules), size 
Of z8b 



L 

library book (macro) names 282 

library book (macro), number of 2 81 

local 3270 table of command codes ^79 



M 



channel program modules (for 

start/stop) ^7y 

channel program modules for BSC zbO 

concurrent OLTEP z7i> 

core image library 277 



macros, IBM-supplied ^8^ 

module names 279 

modules, number of 278 



D 

DACA (display alphameric control 

area) z 8b 

data event control block Z b6 

delete statements 281 

DFTRMLST (define the terminal list 

BTAM) 2 85 

DFTRMLST (table requirements, 
BTAM) 

AUTOLST/AUTOWLST z 86 

DIALST 2 85 

IDLST 265 

QPENLST 285 

SSLAST/SSAWLST z 8 

WRAPLST ^85 

WTTALST </8b 

DTFBT (define the file BTAM) , size 

of table 263 

DTFBT table requirements formula 305, z 53 

DTFBTND (define the file end BTAM) ^55 



I 



online terminal test pattern pnase 

identification 277 

online terminal test patterns 

phases z77 

transients 277 



phase names 277 

phases, number of /77 



relocatable Horary 27! 

relocatable library blocks ill 



transients, BTAM 278 

translation tables z80 



IOCS module sizes 

BSC ^80 

start/stop 2 7^ 

translate tables.. 280 



W 

WTTA subroutine 279 



276 DOS/VS System Generation 



CORE IMA3E LIBRARY 



] Phases ] 



1 1 



Blocks | 

^ 



BTAM online | j 
Terminal Test | | 
Patterns: | 52 | 52 
Transients j 8 j 14 
1 f 

BTAM Transient | | 

Routines j 21 | 23 

(other than j | 

Test Patterns) I I 



L X J J 



BTAM Online Terminal Test Pattern Phase identification 



Phase Names 



Test Patterns for Online Terminal Tests 



IJLBOT02 
IJLBOT03 
IJLBOT04 
IJLBOT05 
IJLBOT06 
IJL3OT07 
IJLBOT08 
IJLBOT09 
IJLBOT10 
IJLBOTll 
IJLB0T12 
IJLB0T13 
IJLBOT14 
IJL30T15 
IJLBOT16 
1JLBOT17 
IJLBOT18 
IJLBOT19 
IJLBOT20 
IJLBOT21 
IJLBOT22 
IJLBOT23 
IJLBOT24 
IJLBOT25 
IJLBOT26 
IJLBOT27 
IJLBOT28 
IJLBOT29 
IJLBOT30 
IJLBOT31 
IJLBOT32 
IJLBOT33 
IJLBOT34 
IJLT2ALC 
IJLT2ROT 
IJLT2TLT 
IJLT2TW3 
IJLT3ALC 
IJLT3ROT 
IJLT3SLA 
IJLT3TLT 
IJLT3TtfS 
IJLT5ALC 
IJLT5ROT 
IJLT5SLA 



Transparent EBCDIC Message 

USASCII Transparency Message 

Normal EBCDIC Message 

Normal USASCII Message 

Alpnameric USASCII Message 

USASCII Printer Message 

USASCII Punch Message 

TRANSCODE Printer Message 

TRANSCODE Punch Message 

TRANSCODE Multipoint Message 

EBCDIC Printer Message 

EBCDIC Punch Message 

EBCDIC Alpnameric Message 

EBCDIC Weak Pattern Message for Switched Line 

EBCDIC Weak Pattern Message for Leased Line 

TRANSCODE tfeak Pattern Message for Switched Line 

TRANSCODE tfeak Pattern Message for Leased Line 

EBCDIC Weak Pattern for OLE SYN Insertion 

EBCDIC 80-Character Transparent Message 

EBCDIC 120-Character Transparent Message 

EBCDIC 144-Character Transparent Message 

3270 Basic EBCDIC Test Pattern 

3270 Model 1 Align EBCDIC Test Pattern 

3270 Model 2 Align EBCDIC Test Pattern 

3270 Orders EBCDIC Test Pattern 

3270 Universal Character Set Test Pattern 

3270 NL/EOM Printer EBCDI2 Test Pattern 

3270 Basic ASCII Test Pattern 

3270 Model 1 Align ^SCII Test Pattern 

3270 Model 2 Align ASCII Test Pattern 

3270 Orders ASCII Test Pattern 

3270 Universal cnaracter Set Test Pattern 

3270 NL/EOM Printer ASCII Test Pattern 

All Character Test for IBM 2848 

Rotate Test for IBM 2848 

Tilt Test for IBM 2848 

Twist Test for IBM 2848 

All Character Test for IBM 1030 

Rotate Test for IBM 1030 

Analyzer Test for IBM 1030 (SELECTRIC) 

Tilt Test for IBM 1030 

Twist Test for IBM 1030 

All Character Test for IBM 1050 or 2740 

Rotate Test for IBM 1050 or 2740 

SELECTRIC Analyzer Test for IBM 1050 or 2740 
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Phasejlaiies Test _ Patterns. .for _Online_rerminal Tests 

IJLT5TL.T Tilt Test for IBM 1050 or 2740 

IJLT5TWS Twist Test for IBM 1050 or 2740 

IJLT6&LC all Character Test for IBM 1060 

IJLT6R0T Rotate Test for IBM 1060 

IJLT6SLA SELECTRIC Analyzer Test for IBM 1060 

IJLT6TLT Tilt Test for IBM 1060 

IJLT6T/JB Twist Test for IBM 1060 



SIAM Transients 



$$A.BERP1 Control handler for BTAM special message writer and error statistics 

recorder 

$$A.BERP2 BSC online test message writer 

$$ABERP3 Console special message writer 

$$ABERP4 Remote 3270 status/sense error recorder 

$$&B2RP5 Error recovery message writer, phase 1 

$$A.BERP6 Error recovery message writer, phase 2 

$$A.B£RP7 Error recovery message writer, pnase 3 

$$ABERP8 RMSR record builder 

$$ftBERP9 Free areas from real storage 

$$BBT3SC OLTEP device assignment 

$$BBT3SI OLTEP device assignment initiation 

$$BCTC01 CLOSE routine 

$$BETPRT Error tnreshold message 

$$BHDRCK Terminal test request validation and comparison 

$$BLEPRT Line error print routine 

$$BL0PEN OPEN routine 

$$BOTC01 OPEN routine 

$$BOTC02 OPEN for local devices routine 

$$BOTC03 OPEN logic processor 

$$B0TC1A. OPEN logic module, phase 3, for non-local devices 

$$BRESPL Reset Polling Lines 

$$BTCNCL Cancel routine 

$$BTMEB3 Terminal test request - IBM 1030 Manual Entry and Badge Reader 

$$BT1030 Terminal test module - IBM 1030 

$$BT1050 Terminal test module - IBM 1050 

$$BT1060 Terminal test module - IBM 1060 

$$BT2260 Terminal test module - IBM 2260 

$$BT2740 Terminal test module - IBM 2740 

$$BT2848 Terminal test module - IBM 2848 

RELOC^TA i BLE_LIBRARX 

r t 1 

| Modules | Blocks | 

j. 1 j 

| 65 | 179 | 

L J_ J 
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Modules 



r t 

Module j 

Name j Description 

X 



"T 1 

| Bytes of 

j Storage 

-X 



:ONCURRENT OLTEP 



T - _ _ - 


— - - ~ T 




BT3270SC) Concurrent OLTEP Setup 


1 


2535 


I J LZ SCAN) 


1 


5796 


x _ . 


. _ X 





CHANNEL PROGRAM 



(For st 



art/stop, 
_ T 

| WTTA 
| IBM 7770 
JIBM 1030 
| IBM 1030 
I IBM 1060 
I IBM 1060 
| IBM 2 848 
|AT&T 83B 
j Western 
j Table Gs 
j IBM 1050 
j IBM 1050 
I IBM 1050 
| IBM 2740 
| IBM 2740 
| IBM 2740 
I IBM 2740 
| IBM 2740 
| IBM 2740 
j IBM 2740 
j IBM 2740 
| IBM 2740 
| IBM 2740 
| IBM 2740 
| IBM 2740 
|TWX 33 
I IBM 7772 



the modules include a taole of special characters.) 



IJL0EZ 
IJL00* 
IJL01J 
IJL01Z 
IJL02J 
IJL02Z 
IJL03Z 
IJL04Z 
IJL05Z 
IJL06Z 
IJL07J 
IJL07iT 
IJL07Z 
IJL08H 
IJL08M 
IJL08P 
IJL08Q 
IJL08R 
IJL08U 
IJL08X 
IJL08iT 
IJL08Z 
IJL081 
IJL082 
IJL089 
IJL09* 
IJL10Y 



(Auto Poll) 
(AutO Poll) 

Remote 
3 

Union 115A 
neration for 2260 Local cnannel Program 

Nonswitched (Auto Poll) 

Switched 

Nonswitcned 

with Station Control (Auto Poll) 

witn Dial, Transmit Control, and Checking 

with Station Control and Checking 

with Dial and Checking 

with Checking 

with Dial and Transmit Control 

with Station Control 

with Dial 

Basic 

and OIU with Dial and Cnecking 

and OIU with Checking 

witn Station Control and Cnecking (Auto Poll) 



124 

76 

187 

139 

175 

127 

209 

78 

72 

16 

132 

202 

124 

97 

176 

132 

172 

141 

122 

92 

114 

93 

246 

181 

145 

110 

76 



WTTA SUBROUTINE 



IJLWTZ | WTTA Subroutines 

x 



1223 



LOCAL 3270 TABLE OF COMMAND CODES 



h T 

IIJL0HZ |3277L table of command 'codes 
l x 



30 
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r t 

Module | 

Name j Description 

x 



"T 1 

| Bytes of 

J Storage 

.-L 



CHANNEL PROGRAM MODULES FOR BSC 

rtie following relocatable modules are BSC channel program modules for switched 
lines using ID verification (CPU-to-CPU) . The correspondence between 
relocatable module name and the codes that appear in the FEATURE operand 
sublist in the DTFBT macro instruction is indicated. 



IJLOBiT 
IJLOBZ 
IJLODx 
IJLODZ 
IJL1BZ 
IJL2DZ 
IJLEDIT3 



For switched lines 

For nonswitcned lines 

IBM 2780 switched point to point 

IBM 2780 nonswitcned point to point 

BSC Multipoint Lines 

IBM 2780 Multipoint for TRANSCODE 

Logic, TP EDIT Macro 



415 
281 
212 
148 
253 
136 
2090 



TABLES OF SPECIAL CHARACTERS 



IJLA3C | In ASCII for BSC 

IJLEBD | In EBCDIC for BSC 

IJLTCD | In 6-bit TRANSCODE for BSC 

j. 



85 
85 
69 



TRANSLATION TABLES 



IJLRASA | For USASCII to EBCDIC for BCS | 256 

IJLRCTW j For ITA2 to EBCDIC (World Trade Teletype) j 256 

IJLRCT1 | From BAUDOT to EBCDIC j 256 

IJLRCT2 j From TWX to EBCDIC | 256 

IJLRCT3 | From ZSC3 to EBCDIC (World Trade Teletype) j 256 

IJLRC30 j From 1080 to EBCDIC | 256 

IJLRC40 j From 2740 to EBCDIC (lowercase) | 256 

IJLRC50 I From 1050 to EBCDIC (lowercase) j 256 

IJLRC60 |From 1060 to EBCDIC | 256 

IJLRC80 | From 6-bit TRANSCODE to EBCDIC | 256 

IJLRF40 | From 2740 to EBCDIC (uppercase) j 256 

IJLRF50 | From 1050 to EBCDIC (uppercase) j 256 

IJLR3CI | From USASCII to EBCDIC with 2848 attached to 2701 via IBM Terminal | 256 

j Control Type III j 

IJLSASA I From EBCDIC to USASCII for BSC | 256 

IJLSCTW | From EBCDIC to ITA2 (World Trade Teletype) j 256 

IJLSCri | From EBCDIC to BAUDOT | 256 

IJLSCT2 | From EBCDIC to TWX j 256 

IJLSCT3 j From EBCDIC to ZSC3 (World Trade Teletype) | 256 

IJLSD30 j From EBCDIC to 1030 | 256 

IJLSDU0 j From EBCDIC to 2740 | 256 

IJLSD50 j From EBCDIC to 1050 | 256 

IJLSD60 j From EBCDIC to 1060 | 256 

IJLSD80 j From EBCDIC to 6-bit TRANSCODE | 256 

IJLSSCI | From EBCDIC to USASCII with 2848 attached to 2701 via IBM Terminal | 256 

j Control Type III j 
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Q^lete^Statements 

To delete the BTAM phases from the core image library, the BTAM modules from the 
relocatable library, and the BTAM books irom the source statement Horary, you must 
supply trie DELET statement for the appropriate library ana* the name of the phase, module, 
or book to be deleted. For example: 

// JOB DELETC 
// EXEC MAINT 

DELETC $$BCT01,$$BETPRr,etC. 

DELETC IJLT2ALC,IJLT2ROT,etc. 

DELETR IJLOOY,IJLOlZ # IJL02Z,etc 

DELETS E. CONTROL, E.LERB, etc 
/& 

To delete both BTAM and QTAM from the core image, relocatable and source statement 
libraries, the DELET statement for the appropriate library and tne following entries must 
be made: For the core image transients, you must supply the DELETC statement witfi a 
separate entry for each transient (QTAM and BTAM) to be deleted. For the core image 
phase names, enter the delete statement as follows: 

DELETC $$BCTC01,$$BOOD03,$$BETPRT,etC. 
DELETC IJLB.ALL 
DELETC IJLT.ALL 

To delete both BTAM and QTAM from the relocatable Horary, enter: 

DELETR IJL.ALL 

To delete the BTAM and QTAM books from the source statement library, enter the DELETS 
statement with a separate entry for eacn book to be deleted. Tne following example shows 
the required delete statements and type of entries to be made in those cards: 

// JOB DELETE 
// EXEC MAINT 

DELETS E. CONTROL, E.CANCELM, etc. 
/& 

SOURCE STATEMENT LIBR ARY 

r T n 

| Macros | Blocks j 

y + j 

| 66 | 8,620 j 

L X J 
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Macros 



| Storage Bytes | 
+ T < 













Storage Bytes 














Basic 

L 


j For Variables 
















E. AS 














E. AS~TR 














E. ASLIST 














E.BTBDNLT 


(inner 


macro 


in 


BTMOD) 






E.BTBTEIH 


(inner 


macro 


in 


BTMOD) 






E.BTBTFIX 


(inner 


macro 


in 


BTMOD) 






E-BTBrFREE 


(inner 


macro 


in 


BTMOD) 






E.BTBTROD 


(inner 


macro 


in 


BTMOD) 






E.BTBTRSCH 














E.BTCEMODE 


(inner 


macro 


in 


BTMOD) 






E.BTCKID 


(inner 


macro 


in 


BTMOD) 






E.BTCONST 














E.BTCSE 


(inner 


macro 


in 


BTMOD) 






E.BTCTCJPT 


(inner 


macro 


in 


BTMOD) 






E. BTMOD 














S.BTMDDIHl 


(inner 


macro 


in 


BTMOD) 






E.BTMODIH2 


(inner 


macro 


in 


BTMOD) 






E.BTNCKID 


(inner 


macro 


in 


BTMOD) 






E.BTOLTCMP 














E.BTOLriH 


(inner 


macro 


in 


BTMOD) 






E.BTONLAP 


(inner 


macro 


in 


BTMOD) 






E.BTONLOA 


(inner 


macro 


in 


BTMOD) 






E.BTRD 














E.BTRLBF 


(inner 


macro 


in 


BTMOD) 






E.BTR2BF 


(inner 


macro 


in 


BTMOD) 






E.BTRWC 














E.BTTRANS 


(inner 


macro 


in 


BTMOD) 






E.BTWAIP 














E.CHSNTRr 










20 (Start-stop) 

72 (BCS) 

20 (Start-stop Auto Poll) 

22 (2260 Local) 


| +6 (note 2) 

|+72 (Note 2) 
j +4 (Note 2) 


E.CONFIGUR 














E. CONTROL 










20 


1+38 (Note 2) 


E.CTR3ROUP 














E.CTRLIST 














E.CTRSCHED 














E.DECJLIST 














E.DISP3UID 














E.DFTRMLST 














E.DTFBT 














E.GDOAS 














E.GDULIST 














E.GDOTRANS 














E.LERB 










20 




E.LERPRT 










14 


|+8 (Note 2) 


E.LOPEN 










8 


|+2 (Note 2) 


E.MAPP0B2 (Note 5) 












E.ONLTST 














E.PARAMNUM 














E.PARMLIST 














E.RELBUF 










14 


|+4 (Note 3) 


E.REQBUF 










12 


|+8 (Note 4) 


E.RESETPL 










12 


|+4 (Note 2) 


E.RMSRTAB 















L ± J- J 
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Storage Bytes 



y 

L 


+- 

— - X 


Basic 


StorageByte s 


T 

j For Variables 


r 


t 






T 


| Z.SAMP327L 










|Z.SAtfP327R 










| E.SCANREQ 










| E.SDRTAB 










| E.STEND 










|E. TGROJP 










lE.TPEDIT 










IE.TRLIST 










IE.TRA.NSL&T 










|E.TRNSLATE 




26 




|+16 (Note 2) 


| E.TRSRCIrt 




256 






|E.TRSRCT3 




2^6 






| E.TRSSCrW 




256 






|E.TRSSCr3 




256 






1 E.rwAir 




24 




|+20 (Note 4) 



L J. X J 

Notes : 

1. n=number of different operands co3ed. 

2. No operands coded in register notation. 

3. First operand not coded in register notation. 

4. All possible operands not coded in register notation. 

5. This is a supervisor generation macro that is also used by BT&M. 

Storage Requirements 

QI?Br_|DEFINE_THE_FILEj _BTkM)_ 

I^BLE_RE£UIREMENTS 

Size = 64 + N (40 + 8x) + BLJFCB + BOFNO (BUFL + f) + y + z 
(+ 32N for BSC only) 

where: 

N = number of lines in the line group (or, for a local 2260 and local 3270**, the 

number of devices attached to the control unit) 
x = number of CCtfs in the largest channel program available for the device, given 

in Figure 20-1 

♦ BUFCB = 8 if a buffer pool is use:! 

= if a buffer is not used 
♦BUFNO = number of buffers in tne pool 
♦BUFL = length of each buffer 

f = number of bytes required to extend each buffer to a multiple of 8 
y = size of the model channel program table for the line group, given in Figure 

20-1. If two or more DTFBTs use the same model channel program and are 

linkage edited together, include the value only once. 
Z = Size of the table of special characters given in Figure 20-1. For BSC only, 

if two or more DTFBTs use the same transmission code, include the value only 

once. 

* If the buffer pool is shared by two or more DTFBTs, include the value only once. 
** For a local 3270, at least one DTFBT is required for each control unit. 
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Device 

1030 

1050NS 

1050S 

1060 

2260L 

2260R 

2740 

2740C 

2740DC0 

2740C0 

2740D 

2740DC 

2740DT 

2740DrC 

2740S 

2740SC 

3277L 

115A 

83B3 

I-tfX 33/35 

WTTA 

BSC1; also 1130, 2780, and 2020 

nonswitchea point to point 
BSC2; also 1130, 2780, and 2020 

switched point to point 
BSC3; also 1130, 2780, 2020, and 

2972 multipoint. 
2780 transcode, nonswitched point 

to point. 
2780 transcode, switched point 

to point 
2780 multipoint 



without 

start/stop 

7 
7 
11 
6 
1 
7 
4 
4 



with 



Auto Poll 

9 
9 

9 



+- 



84 

68 
136 

80 
Not applicable 
136 

24 

68 
207 
155 

52 
100 

68 
116 

48 

84 

28 

36 

40 

56 

52 
248 

372 

252 

111 

175 

123 



23 

16 

34 

15 
Not applicable 

20 

21 

33 

30 

24 

18 

32 

22 

36 

12 

24 
Not applicable 
4 
6 

18 

36 

53 

53 
53 
53 
53 
53 



Figure 20-1. BTAM — Parameters for DTFBT Table Requirements Formula 
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DTFBTND (Define The File End: BTAM). 

mis macro instruction does not require storage at execution tine. 

DFTRMLSr (Define The Terminal List:. BTAM)_ 

Table _ Requirements for ...OPENLST_and_WR?VPLST 

Size = n (m + 1) +2 

where: n = number of list entries 

m = number of polling/addressing characters -- a function of the device, as shown 
in Figure 20-2. 



Device 



| 1030 




1 1 


| 1050NS 




2 1 


| 1050S 




2 1 


| 1060 




2 1 


| 2260L 


Not 


applicable | 


| 2260R 




2 1 


| 2740 


Wot 


applicable | 


| 2740C 


Not 


applicable | 


| 2740D 


Not 


applicable | 


| 2740DC 


.Not 


applicable | 


| 2740DT 


Not 


applicable | 


| 2740DTC 


Not 


applicable | 


| 2740S 




1 1 


| 2740SC 




1 1 


| 2740DC0 


Not 


applicable J 


| 2740CO 


Not 


applicable | 


| 3277R 




5 1 


| 115A 




2 1 


| 83B3 




2 1 


| 1130 




2 1 


| 2780 




3 1 


| tfTTA. 


Not 


applicable | 


L J 


L 


_j 



Figure 20-2. BTAM — Number of Polling/A.ddressing Characters 

Table Requirements for .DIA.LST 

Size = n(m +1) +l+q+p+i 

where: n = number of list entries 

m = values specified in Figure 20-2 

q = 2 if the list includes entries for polling or addressing 

= otherwise 
p = number of dial digits 
i = 3 if the in-list operand is coded (BSC) 

= otherwise.. 

Table Requirements for IDLST 

Size of TtfX calling list = d + 5 + 2b 

Size of TWX answering list = 5 + b 

Size of BSC IDLST only =3+d+2r+s+i 

wnere: d = number of dial digits 

b = number of TWX ID characters 

= otherwise 
r = number of ID characters expected to be received (BSC only) 
s = number of ID characters to be sent (BSC) 
i = 3 if the in-list operand is coded (BSC) 

= otherwise. 
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Table Requirements f or_SSLAST/SSAWLST 

Size = n(m + 1) + 6 

wnere: n = number of list entries 

m = values specified in Figure 20-2. 

Table Requirements X or jVOTOLST/AUroWLST 

Size = n(m + 2) + 819 

wnere: n = number of list entries 

m = values specified in Figure 20-2. 

Table Reguirementsfor WTTALST 

1. Wnen the WRU feature is present in DTFBT: 
Size = 3 + 2r + s 

2. When the IAM feature is present, and WRU is not present in DTFBT: 

Size = 2 + s 

where: r = number of ID characters expected to be received 
s = number of ID characters to be sent. 

i£MOD_£BTAM_Logic_^qdule)_ 

Tne size of the BTAM module varies with the options selected as shown in Figure 20-3. 
When all operands are omitted or the standard (default) options are coded, tne resulting 
basic module requires 7811 bytes of main storage. 

BTAM DATA EVENT CONTROL. .BLOCK TABLE REQUIREMENTS 

Size = 40 bytes 

When the MF operand of a READ or WRITE macro is coded MF=L, or wnen the MF operand is 
omitted, a DECB (Data Event Control Block) is reserved. One DECB should be reserved per 
line. 

SCANRED_DECB_RE2UIREMENTS 

Size of each DACA = 24 bytes 

When the MF operand of a SCANREQ macro is coded MF=L, or when the MF operand is omitted, 
a DACA (Display Alphameric Control Area) is reserved. One DACA should be reserved per 
device. 
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r T T 

I Operand | Option | Number of bytes adaed to basic nodule 



-2237 



ERL03IC=* 



+ 351 
-1942 



YES 



+ 712 (If BUFFER=NO f BSCTEST=NO) 

+ 2813 (If BUFFER=YES, BSC=YES, BSCTEST=NO) 



+4340 (If BOFFER=YES, BSCTEST=YES) 



swirca 



NEtfID 



+1034 (If BUFFER=NO, BSCTEST=NO) 

+3135 (If BUFFER=YES, BSCTEST=NO) 

+ 4662 (If BUFFER=Yh;S, BSC=YES, BSCTEST=YES) 



AUDIO 



YES 



+ 468 (SWITCH must equal YES) 



YES 



+2077 {If L2260=WO and L3277=NO) 
+1835 (If L2260=YES or L3277=YE3) 



BUFFER= 



REQREL 



+ 681 (If L226 0=NO and L3277=NO) 
+ 781 (If L2260=YES or L3277=YES) 



TERMTST= 



YES 



+ 1028. 



- 616 (If ERLOGIC=U) 



L2260= 



L3277 



YES 



NO 



-2964 


(If 


S3=NO) 


+ 1917 


(If 


ERLOGIC=E) 


-2720 


(If 


S3=NO) 


+ 2268 


(If 


ERLOGIC=C) 


-2595 


(If 


S5=NO) 


- 321 


(If 


ERLOGIC=nC) 



-2899 (If SS=NO) 



* Use the ERLOGIC storage estimate only if neither L2260, nor L3277,| 
nor SSAPL is specified. | 

L J 

Figure 20-3. BTAM — Storage Requirements (Part 1 of 3) 
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r t t 

Operand | Option | Number of bytes added to basic module 



+ 860 (If ERLOGIC=m) 



-1299 (If S3=NO) 



L2260 



L3277 



NO 



YES 



+ 4057 


(If 


ERLOGIC=E) 


- 705 


(If 


SS=NO) 


+ 4404 


(If 


ERLOGIC=C) 


- 580 


(If 


SS=NO) 


+ 1529 


(If 


ERLOGIC = ljC) 



-1174 (If SS=NO) 



L2260 



L3277 



YES 



YES 



+ 1745 (If ERLOGIC=lnI) 



- 700 


(If 


SS=NO) 


+ 4864 


(If 


ERLOGIC=L) 


+ 190 


(If 


SS=NO) 


+ 5215 


(If 


ERLOGIC=C) 


+ 315 


(If 


SS=NO) 


+ 2040 


(If 


ERLOGIC=ljC) 



- 575 (If SS=NO) 



TST3277 



YES 



+ 978 (nL3277 must equal YES) 



TRANSL= 



YES 



+ 170 



+12066 (If SWITCa=YES and BUFFER=YES) 



BSCS = 



YES 



+ 6068 


(If 


SS=NO) 


+ 8949 


(If 


StfirCtf=YLS and BUFFER=NO) 


+ 5128 


(If 


SS=NO) 


+ 6435 


(If 


StfirCH=NO and BUFFER=NO) 


+ 2934 


(If 


SS=NO) 


+ 9389 


(If 


StfirCH=NO and BUFFER=YES) 


+ 5795 


(If 


SS=NO) 


+10257 


(If SWirCH=dEWID and BUFFER=NO) 


+ 7212 


(If 


SS=NO) 


+13390 


(If StfITCH=LNiEtfID and BUFFER=YES) 



+10335 (If SS=N0) 



Figure 20-3. BTAM -- Storage Requirements (Part 2 of 3) 
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r t t 

| Operand | Option | Number of bytes aided to basic module 
h + 



| SSAPL= 



YES 



-1151 (If ERL03IC=w) 
+1622 (If ERLOGIC=L) 



- 856 (If ERLOGIC=WC) 
+1981 (If ERLOGIC=C) 



BSCMPr= 



YES 



+1190 (BSCS must equal YES) 



WTTA 



YES 



+ 360 



BSCTEST 



YES 



+4122 (BSCS must equal YES) 



DECBEXI 



YES 



50 (BSCS must equal YES) 



| RMSR = 

I 

I 



YES 



+1474 (If L2260=NO and L3277=NO) 



+ 1714 


(If L2260=YE3 and L3277=WO) 


+ 1494 


(If L2260=NO and L3277=YES) 



+ 1966 (If L2260=YES and L3277=YES) 



| RESETPL | NO 
L L 



- 128 



Figure 20-3. BTA.M -- Storage Requirements (Part 3 of 3) 
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Module Outline 



core image library 293 

transients 293 

relocatable Horary 293 

modules 293 

basic QTAM logic modules 293 

QTAM device I/O modules 293 

delete statements 296 

source statement library 297 

macros 297 

QTAM storage requirements 298 

DTFQT (define tne file: QTAM) 298 

control information 299 

buffers 300 

QTAM macro instructions... 300 
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Module Index 



basic logic modules and storage 

requirements 293 

basic QTAM logic modules 293 

buffer requirements, nonaudio 

applications 300 



control information storage 

requirements 299 

core image library 293 

core image library blocks 

(transients) 293 



real storage destination queue, 
table requirement 299 

real storage process queue table 
requirement 299 



M 



macros, IBM-supplied 297-304 

macro instructions storage 

requirements 301-304 

module names 293-295 

modules, number of 293 



relocatable library 

relocatable Horary blocks. 



293 
293 



delete statements 296 

device I/O modules requirements 293 

DTFQT 

(define the file QTAM), size of 

tables 
audio output queue table 

requirements (QTAM) 299 

checkpoint records table 

requirements 299 

communication line group file 

table requirements 298 

library book (macro) names 297 

library book (macro), number of 297 

message queues file table 

requirement QTAM. 298 



source statement Horary blocks 
source statement library macros, 



transient routines 

transients, IBM-supplied, 



297 
297 



293 
293 



values for communication line 
group table , 
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22RE_IM^GE_LIBRAR^ 

r t 1 

| Transients | Blocks | 
j. + ., 

| 23 | 35 | 

L x j 

Transients 



$$BC2C01 
$$BC2C02 
$$BC2C03 
$$BC2C04 
$$BOQ001 
$$BO2O02 
$$BO2O03 
$$BOQO04 
$$BOQO06 
$$BOQO07 
$$BO2O08 
$$BQCNCL 
$$BQC[NICM 
$$BQHDCK 
$$BQWTRA 
$$BQWTR1 
$$BQWTR2 
$$BQWTR3 
$$BQ1030 
$$BQ1050 
$$BQ1060 
$$BQ2260 
$$BQ2740 



Close Pnase 1 

Close Phase 2 

Close pnase 3 

Close Phase 4 

Open Monitor/DASD Message Queues, Pnase 1 

Open Line Group and Main Storage Process/Destination 2ueues 

Open cneckpoint/Restart, Phase 1 

Open Checkpoint/Restart, Phase 2 

Open Main Storage Process/Destination Queues 

Open Phase 7 

Open Audio Line Group and Output Queue 

Cancel 

Cancel 

Terminal Test Header Analysis 

ARU Message Writer 

Message Writer, Phase 1 

Message Writer, Phase 2 

Message Writer, Phase 3 

Terminal Test Module for IBM 1030 

Terminal Test Module for IBM 1050 

Terminal Test Module for IBM 1060 

Terminal Test Module for IBM 2260 

Terminal Test Module for IBM 2740 



RELOCATABLE LIBRARY 



1 Modules 
I- 



Blocks 
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393 



Modules 

BASIC_2TAM_LOGIC_MODULES: Basic 2IA-M logic modules are identified by one asterisk (*) 
preceding the listed module. 

2TAM_DEVICE_I/0_MODULES: QTAM device I/O modules are identified oy two asterisks (**) 
preceding tne listed module. Include the storage requirements for a particular device 
I/O module only once, and only if the terminal type is present in the system. 



Module 




| Bytes of 


Name 

j 


Description 

L 


| Storage 


1 
IJLQAA 


r 

Audio line appendage 
Note: Required if the QThM auuio support is selected. 


| 2386 


IJLQAD 


Audio 7772 disk appendage 


| 2898 


IJLQBO 


Breakoff (BREAKOFF) 


j 212 


*IJL2CK 


Checkpoint 


| 1208 




Note: Required if the Checkpoint/Restart facility is selected in 


tne| 




DTF2T. 




IJLQCL 


Change line (STARTLN and STOPLN) 


| 557 


IJLQCM 


Cancel message (CANCELM) 


| 160 


IJLQCP 


Change polling list entry (CfctNGP) 


| 146 


IJLQCR 


Checkpoint request (CKREQ) 


| 98 


IJLQCT 


Change terminal table entry (CnNGT) 


| 250 



L J. X J 



Module 21: QTAM — 5745-SC-2TM 293 



j Module 

| Name 

h 

j*ul2da 



IJLQDC 
IJL2DE 
IJLQDL 
IJLQDP 
IJLQDQ 
IJLQDT 
IJLQEA 
IJLQEB 
IJLQEC 
IL2ER 
IJLQEX 
IJLQFL 
IJLQ3A 
IJLQ3B 
IJLQ3C 
IJLQ3D 
IJL23M 
IJLQ3R 
|IJLQ35 
J+IJL2IP 
|IJLQir 
|»IJL2LA 

I 
|*IJL2LC 



IJL2L3 
IJL2LK 
♦IJL2LD 

IJLQMC 

IJLQMI 

IJLQMM 

IJL2MP 

IJLQMT 

♦IJL2MW 

♦♦IJL2M0 

♦♦IJL2M1 

♦♦IJL2M2 

♦♦IJL2M3 

**IJL2M*t 

♦♦IJL2M5 

♦♦IJL2M6 

**IJL2«8 

♦♦IJL2M9 

**IJL2N0 

♦+IJL2N1 

♦♦IJL2N2 

♦♦IJL2N3 



|**IJL2N»» 

I 
|*+IJL2N5 

|**UL2N6 
J**IJL2N7 

I 
|**IJL2N8 

|IJL20A 
| I JL20B 
IIJLQOC 
|IJLQPA 



Description 

Disk I/O module 

Note: Not required when the system contains only audio devices. 

Copy counters (COPYC) 

Copy terminal table entry (COPYD 

Distribution list 

Copy polling list entry (COPYP) 

Copy queue control block; status (COPYQ) 

Insert date in message neader (DATESTMP) 

End-of-Address (EDA) 

End-of-Block (EOB) 

End-of-Block and line correction (EOBLC) 

Error message (ERRMSG) 

Expand message header 

DTF locator 

Get audio message 

Get audio or nonaudio message 

Get audio message or nonaudio message record (GET) 

Get audio message or nonaudio message segment (GET) 

Get complete message (GET) 

Get message record (GET) 

Get message segment (GET) 

QTAM implementation 

Intercept message (INTERCPT, permanent queueing) 

Line appendage and ERP module PCI and program 

Note: Not required when the system contains only audio devices. 

Line appendage for PCI and program check, module 

Note: Not required when the system contains only audio devices. 

Audio input message logging (LOGSEG) 

Lookup terminal table entry (DIRECT) 

IBM 2260 local appendage 

Note: Required if the IBM 2260 local device is used. 

Conversational mode (MODE) 

Initiate mode (MODE) 

Message-mode interface (MODE) 

Priority mode (MODE) 

Compare message type (MSGTYPE) 

Error recovery procedures message writer subtask 

Model channel program for IBM 1030 terminals 

Model channel program for IBM 1060 terminals 

Model channel program for IBM 2260 terminals 

Model channel program for AT&T 83B3 terminals 

Model channel program for western Union Plan 115A terminals 

Model channel program for IBM 1050 switched and nonswitched termin 

Model channel program for IBM 1050 nonswitched terminals 

Model channel program for AT&T TWX terminals (Models 33 and 35) 

Model channel program for IBM 2260 local terminals 

Model channel program for IBM 2740 basic terminals 

Model channel program for IBM 2740 oasic dial terminals 

Model channel program for IBM 2740 terminals with station control 

Model channel program for IBM 2740 terminals with station control 

checking 

Model channel program for IBM 2740 dial terminals witn transient 

control and checking 

Model channel program for IBM 2740 terminals witn checking 

Model channel program for IBM 2740 dial terminals with checking 

Model channel program for IBM 2740 dial terminals with transmit 

control 

Model channel program for World Trade Telegraph terminals (WTTA) 

Operator awareness 

SDR counter incrementer 

Operator control (OPCTL) 

Put audio message (POT) 



T T 

Bytes of 
Storage 



-+- 



als 



1372 

280 

120 

156 

104 

98 

60 

100 

132 

396 

292 

70 

78 

324 

732 

760 

714 

472 

500 

454 

3692 

140 

4152 

630 

304 

104 

1288 

384 

18 

44 

36 

60 

1359 

194 

168 

206 

102 

91 

207 

194 

113 

75 

99 

166 

172 

221 

198 

128 

192 
156 

356 
1380 
2576 
3530 

370 



-i 
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Module 
Name 

IJLQPL 
IJLQPM 
IJLQPR 
IJLQP3 
IJLQPZ 
IJLQ2T 
IJLQRA 
IJLQRB 

IJLQRC 
IJLQRD 
IJLQR3 
IJLQRM 
IJLQRR 
IJLQRS 
*IJL2RW 

IJLQR1 
IJLQR2 
IJLQR3 
IJLQR4 
IJLQR5 
IJLQR6 

IJLQR7 
IJLQR8 
IJLQR9 
IJLQ3B 

IJLQSC 
IJLQSfl 
IJLQSI 
IJLQSK 
IJLQSD 
IJLQSR 
IJLQSS 
IJLQST 
IJLQSI 
IJLQS2 
IJLQS4 
IJLQS5 
IJLQS6 

IJLQS7 

IJLQSS 
IJLQS9 

♦IJLQTA 

IJLQrR 



IJLQTS 

*UL2rr 



Description 

Polling limit control (POLLIMIT) 

Put complete message (PUD 

Put message record (PUT) 

Put message segment (PUD 

Pause-transmit idle characters (PAUSE) 

Close message control (CLOSEMC) 

Translate table RCVARU: ARU code to EBCDIC 

Translation table RCVITA2 (EBCDIC to International Telegraph Alphabet 

No. 2) 

Translation taole RCVZ-RCVZC3 (EBCDIC to figure-protected code ZSC3) 

Retrieve message segment by DASD address (RETRIEVE) 

Route message (ROUTE) 

Release message (RELEASED) 

Reroute message (REROUTE) 

Retrieve message header by sequence number (RETRIEVE) 

Physical input/output control 

Note: Not required when the system contains only audio devices. 

Translate table RCV1030: 1030 to EBCDIC 

Translate table RCV1050: 1050 to EBCDIC 

Translate table R2V1050F: 1050 to monocase EBCDIC 

Translate table R2V1060: 1060 to EBCDIC 

Translate table RCV2260 to EBCDIC 

Translate tables RCV83B3 or RCV115A: AT&T 83B3 or WU plan 115A to 

EBCDIC 

Translate table RCVTWX: AT&T models 33/35 (TWX) to EBCDIC) 

Translate table RCV2740: 2740 to EBCDIC 

Translate table RCV2740F: 2740 to EBCDIC 

Translation table SNDITA2 (International Telegraph Alphabet No. 2 to 

EBCDIC) 

Translation table SNDZSC3 (figure-protected code ZSC3 to EBCDIC 

Scan message header 

Sequence-in number verification (3E2IN) 

Skip-through cnaracter (SKIP) 

Insert sequence-out number in message header (SEQOUD 

Source terminal name verification (SOURCE) 

Change audio line (STARTARU and SIOPARU) 

Skip-on count (SKIP) 

EBCDIC to 1030 

EBCDIC to 1050 

EBCDIC to 1060 

EBCDIC to 2260 
Translate tables SND83B3 or 3ND115A EBCDIC to AT&T 83B3 or WU plan 
115A 

Translate table SNDTWXE: EBCDIC to AT&T models 33/35 — TWX (even 
parity) 

Translate table SND2740: 
Translate table SNDTWXO: 
(nonparity) 

World Trade Telegraph terminals (WTTA) line appendage 
Note: Required if World Trade Telegrapn support is selected. 
Code translation used in conjunction with QTAM or user-provided 
translate table (TRANS) 

Note: T = number of translation tables. 
Insert time of day in message header (TIMESTMP) 
Terminal test recognition (LPSTARD 
Note: Not required when the system contains only audio devices. 



+- 



Translate table SND1030: 
Translate table SND1050: 
Translate table SND1060: 
Translate table SND2260: 



EBCDIC to 2740 

EBCDIC to AT&T models 33/35 -- TWX 



Bytes of 
Storage 

120 
480 
544 
520 
3b0 
474 
266 
266 

266 
124 

48 
234 

72 

380 

1569 

266 
266 
266 
266 
266 
266 

266 
266 
266 
266 

266 
104 
140 

76 

68 
128 
300 

48 
266 
266 
266 
266 
266 

266 

266 
266 

1406 

114 + 

226T 

198 
1394 
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Delete _statements 

To delete the QTAM pinases from the core image library, the QTAM modules from trie 
relocatable library, and the QTAM books from the source statement Horary, the DELET 
statement for the appropriate library ana the name of the phase, module or book to De 
deleted must be supplied. For example: 

// JOB DELETE 
// EXEC MAINT 

DELETC $$BCQC01,$$BQWTRl,etC. 

DELETR IJLQBO,IJLQCL,IJLQCM,etC. 

DELETS E.BREAKOFF, E. BUFFER, E . CANCELM, fctc. 
/£ 

To delete both BTAM and QTAM from the core image, relocatable and source statement 
libraries, the DELET statement for the appropriate library and tne following entries must 
be made: For the core image transients, you must supply the DELETC, card witn a separate 
entry for each transient (QTAM and BTAM) to be deleted. For the core image phase names, 
enter tne delete statement as follows: 

DELETC $$BCTC01,$$BCOO03,$$BETPRT, etc. 
DELETC IJLB.ALL 
DELETC IJLT.ALL 

To delete both BTAM and QTAM. from the relocatable library, enter: 

DELETR IJL.ALL 

To delete the BTAM and QTAM books from tne source statement library, enter tne DELETS 
statement with a separate entry for each book to be deleted. The following example shows 
tne required delete statements and type of entries to be made: 

// JOB DELETE 
// EXEC MAIN! 

DELETS E. CONTROL, E.CANCELM, etc. 
/& 
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SOURCE STATEMENT LIBRARY 

r t t 

| Macros | Blocks | 

y x j 

j 79 | 2013 | 

L X J 

Macros 

Basic 

E. ARUM3TYP 
E.BREAKOFF 
E.BUFARU 
E. BUFFER 
E. CANCELM 
E.CHECKARU 
E. CHH3P 
E.CHN3T 
E.CKRE2 

e.closevic 

E. COPYC 

E.COPYP 

E. COPY2 

E.COPYT 

E. COUNTER 

E.CTLTBL 

E. DATESTMP 

E. DIRECT 

E. DTF2T 

E.ENDRCV 

E.ENDREADY 

E.ENDSEND 

E.EOA 

E.EOB 

E.EOBLC 

E.ERRMS3 

E.INTERCPT 

E.LCBO 

E.LINE 

E.LINETBL 

E.LIST 

E. LOSSES 

E.LPSTART 

E.MODE 

E.MSGTYPE 



E.OPCTL 

E. OPTION 

E. PAUSE 

E.POLL 

E-POLLIMIT 

E.POSTARU 

E.POSTRCV 

E.POSTSEND 

E.PREFIXD 

E. PROCESS 

E.QCBD 

E.RCVdDR 

E.RCVITA2 

E.RCVSE3 

E.RCVZSC3 

E.RELEASEM 

E. REPEAT 

E. REROUTE 

E. RETRIEVE 

E. ROUTE 

E.SENDHDR 

E.SENDSEG 

E.SEQIN 

E.SEQOUT 

E.SKIP 

E.SNDITA2 

E.SNDZSC3 

E. SOURCE 

E.STARTARU 

E.STARTLN 

E.STCBD 

E.STOPARU 

E.STOPLfU 

E.TERM 

E.TERMTBL 

E.TERMTBLD 

E.TIMESTMP 

E. TRANS 

E.tfORD 

E.WORDTBL 

E.tfRU 

SY§.t§iD_ Gene rat ion 

E.IJL2DSCT 
E.IJLQTSVC 
E.IJLQDEQU 
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2£^_SrORAGE_REQUIREMENTS 

The storage requirements for QTAM depend to a great extent on the configuration of your 
teleprocessing installation and tne nature of your applications. Storage requirements 
increase proportionately as the number of communication lines, terminals, and 
2TAM-provided processing functions increase. These requirements can be estimated from 
formulas and tables presented in this module. 

To determine the storage requirements for the Basic QTAM Logic modules and the QTAM 
Device I/O modules, refer to "Relocatable Library". 

DrF2T_(.Define_The_Filej QTAM)_ 



Seven types of DTF taoles may be generated by a DTFQT macro instruction, 
estimates for each follow. 

DASD^Message Queues Files 

Size = 315 bytes 

Communication Line Group File 

For Honaudio Line 3roup 

Size = 48 + (128 + 8x) N 



The storage 



For Audio Line Group 

Size = 64 + (161 + Lj. + L 2 + G + x-z)Im 

where: N = number of lines in the line group 

x = a function of the device, given in Figure 21-1 

Lj. = length of input buffers 

L 2 = length of address chain buffers 

G = 9 when using time stamping option, otherwise = 

z =17 when information mode is used 



Device 



1- 



|1030 




8 


|1050NS | 


8 


|1050S 




10 


|1060 




7 


|2260 


Remote | 


8 


|2260 


Local | 


5 


|274A 




4 


|274B 




6 


|274C 




6 


|274D 




7 









j Device 
1- 



274E 

274F 

274G 

274H 

115A 

83B3 

TWX33/35 

7770 

WTTA 




Figure 21-1. QTAM — Values for Communication Line Group Table 
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Real_3torage_Process_2ueue 

Size = 84 + 12x 

where: x - for nonmixed application, and 
1 for mixed application 

Real Storage Destinat ion Queue 

Size - 80 bytes 

^^ckpoint_Records_File 

Size - 220+L 

where: L - length of the checkpoint record specified by the SOrtA keyword operand. 

^u3io_Ou^p^t_Q^eue 

Size = 76 bytes 

S0NTROL_INFOR^ATI0N 

The storage estimates for reguired control information are shown in Figure 21-2. 



| Control Blocks and Information 



Storage Requirements (in bytes) 



Terminal table 

TERMTBL macro instruction 

OPTION macro instruction 



TER.V1 macro instruction 1 



LIST macro instruction 1 



PROCESS macro instruction 1 



12 



No storage is reserved for this macro; it defines 
user areas that are included in the expansion 
of the TERM macro instruction (U parameter) 



9 + .L + U + D + 44F 
where: (I + U + D)<243 



12 + L + 2N + 140 2 
where: (3 + L +2N)<243 



13 + A for audio process program entry 
9 + Y for nonaudio process program entry 



Polling list 

POLL macro instruction 3 



4 + 3N for autopolled terminals except IBM 1030 

4 + 2N for nonswitched terminals or autopolled 
IBM 1030 

5 for switched IBM terminals 
3+1 for TtfX 

4 + T for WTTA terminals 



Queue Control Block for Process 
Queues and Destination Queues 



32X 



Audio Line Table 

LINEIBL macro instruction 1 

LINE macro instruction 1 



4 

5 + Z 



Audio tford Table 

WORDTBL macro instruction 1 

tfORD macro instruction 1 



| 8 + W 
.x 



Figure 21-2. QTAM -- Storage Requirements for Control Information (Part 1 of 2) 
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r 

where: 

N = number of terminals 

I = number of bytes in terminal ID 

CJ = number of bytes in optional area 

D = number of bytes in device address area; size depends on contents: 

For nonswitched terminal — addressing and polling characters (1 byte/cnaracter) 

For IBM switched terminal -- field telling the number of dial digits (1 byte) + dial 
digits (1 byte/digit) + addressing characters (1 byte/character) 

For ItfX -- field telling the number of dial characters (1 byte) + dial digits <1 
byte/digit) + field telling the number of ID characters (1 oyte) + ID cnaracters (2 
bytes /character) 

For dTTh terminals -- 1 byte + field telling the number of ID characters (1 byte) + ID 
characters (2 bytes/character) 

For IBM 2260 Local -- a field of 6 fullwords consisting of a CCB and other control 
information 

L = number of bytes in name of the distribution list entry in terminal table (1-8) 

A - number of bytes in name of the audio process entry in tne terminal table. Because 

the following field in the entry must oe aligned to a fullword boundary, this field 

must be either three, seven or eleven bytes long. 
X = number of lines or terminals (depending on queueing techniques) and the number of 

process queues 
5f = number of bytes in name of the process entry in terminal table (1-8) 
Z = number of bytes in name of the line entry in line table (1-8) 
a = number of bytes of the selected word 
F = 1 for IBM 2740 Model 2 terminals with the Buffer Receiver Option; for other 

terminals 
T = number of bytes in the CPU identification (WTTA terminals) 
h 1 

Notes : 

1. Add the number of bytes necessary for fullword boundary. 

2. This number (140) is the number of bytes in the Distribution List module (IJLQDL). 
This number is included in the storage requirements only once if the LISI macro is 
used more than once. 

3. Add the numoer of bytes necessary for halfword boundary. 
l J 

Figure 21-2. QTAM -- Storage Requirements for Control Information (Part 2 of 2) 

Buffers 

For Nonaudio Applications: 

Buffer Pool Size = 8+(x+16)N + 24M 

N = number of buffers specified 

X = size of each buffer 

M = number of CCWs QTAM generates for data insertion by the PAUSE macro. 

QTAM Macro Instructio ns 

Figure 21-3 gives the storage requirements for all other QTAM macro instructions. 

Much QTAM logic consists of modules introduced by the use of certain QTAM macro 
instructions in the user's program. These macro instructions expand into inline coding 
that establishes the linkage to, and parameters for, the QTAM modules. Often a module so 
introduced into the system itself introduces another module, a process termed a second 
level routine. 
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Column two of Figure 21-3 shows the extent of the coding produced by the expansion of 
the macro instruction in column one. If the coding links to 2TAM module, the module is 
presented in column three; if that module links to other modules, they are presented in 
column four. 

Storage requirements for a sharable module, or for a second level routine that is 
linked to more than once in the same partition are included only once. For example, the 
macro instructions DIRECT, EOh, and ROUTE all link to the same module, IJLQLK. If two or 
more of these macro instructions are used in the same message control program, tne module 
is included only once. Similarly, if the same macro instruction is used more than once 
in the same program, storage is required for only the additional linkage because the 
module is included just once. 



Macro Instruction 
kRUMGTYP 



Inline 
Linkage 
or Code 
(Note 5) 



Second Level 
Sharable Modules 



Name 



Size 



Routine 



Name | Size 
+ 



16 



BREAKOFF 

ANCELM 
CHECKARU" 



IJLQBO 



212 



IJLQCM 



160 



70 + 
message 
text 



CHNGP 



42 



IJLQCP 



146 



IJLQFL 



:hngt 



26 



IJLQCT 



250 



CKREQ 



10 



IJLQCR 



98 



:losemc 



IJL22T 



474 



IJLQCL 



549 



:opyc 



24 



IJLQDC 



504 



COPYP 



34 



IJLQDP 



104 



IJLQFL 



COPYQ 



34 



IJLQDQ 



98 



COPYT 



30 



IJLQDE 



120 



COUNTER 



12 



DATESTMP 



IJLQDT 



60 



IJL2EX 



70 



DIRECT 



12 



IJLQLK 



104 



ENDRCV 



10 



Note 1 



■+ 



ENDRCV (WTTA) 



16 



IJLQEB 



132 



ENDREAD? 



80 



Note 1 



ENDSEND 



10 



Note 1 



EOA 



28 



IJLQEA 



100 



IJLQSH 
IJLQSK 
IJLQRS 
IJLQMT 
IJLQLK 



104 
76 
48 
60 

104 
Note 2 



Figure 21-3. QTAM -- Storage Requirements for Other Macro Instructions (Part 1 of 5) 
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|In 


Line 








| Second 
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Translation tables are: RCV1030, RCV1050, RCV1050F, RCV1060, RCV2260, RCV2740, 
RCV2740F, RCVARU, RCV83B3, RCV115A., RCVTWX, RCVITA.2, RCVZSC3, SND1030, SND1050, 
SND1060, SND2260, SNDITA2, SNDZSC3, SND2740, SND83B3, SND115A, SNDTWXE, and SNDTtfXO 
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Notes 



These delimiters or modules cause linkages to QTAM routines included in "Basic 
2T&M Logic Modules" listed earlier in this module under "Relocatable Library". 

If the macro instruction MS3TYPE, ROUTE, or SKIP (S) is used in the program, tne 
storage estimate for IJLQMT, IJLORG, or IJLQSK, respectively, is not included in 
the storage estimate for EOh, 

Because the user defines his own DlFxx and xxMOD macros for his message log file, 
the size requirements cannot be specified here. Information to determine the 
storage requirements for the specific logging medium is given under the pertinent 
DTF and Module, that is, DTFMT and MTMOD for Tape. Modules 7-18 contain storage 
requirements 'for declarative macros. 

Identifies entry point for RCVSEG and SENDSEG subgroups of LPS. 

Tne linkage requirements for OPEN, CLOSE, GET, and PUT are given in Module 1. 
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Introduction 

This section of the manual presents a method for estimating the amount of storage 
required to run VTAM level 2 (referred to as VTAM) under DOS/VS. For further details, 
refer to DO£ZV£ VTAfl Concepts and Planning, GC27-6998. Information on library 
requirements, VTAM phases, modules and transients, and link-edit statements is given 
under "VTAH Components'*. 

Storage Estimates for VTAM 

mis chapter discusses tne method for estimating the amount of virtual, real, and 
auxiliary storage required to run VTAM under DOS/VS. It also shows how to calculate the 
VTAM storage pool parameters. A sample calculation for the ALLOC and ALLOCR macro 
instructions is given in Figures 22-4 and 22-5. 

Tne results of the estimates are used during system generation and VTAM 
initialization. The virtual and real partition size values are to be specified in tne 
ALLOC and ALLOCR job control commands, the storage pool parameters during the starting of 
VTAM, and the value for the SIZE parameter is to be specified in the EXEC job control 
statement or the job control command. 

The method for estimating the amount of storage required for VTAM and for calculating 
the VTAM storage pool parameters is based on a series of work sheets (WS.) that allow the 
user to define and calculate the requirements step-by-step. As in all telecommunications 
systems, many variables affect the actual storage requirements. Many of the variables 
are precisely defined by the selection of options and functions, and of the network 
configuration. Other variables, nowever, are related to the user's specific 
applications, and as such, are affected by dynamic changes that occur during the 
execution of tne application program. Tnus, in tne work sheets, where precise values are 
not available, guidelines are provided to allow to analyze tne requirements and select 
values applicable to the specific installation. The storage and buffer pool calculations 
found in the work sheets represent starting values which can oe changed oy using the VTAM 
storage pool trace facility. 

The calculations for the virtual and real partition size nave to cover the various 
functional components of VTAM. It will be easier to understand the structure of the 
necessary calculations by referring to Figures 22-1 and 22-2; they show the composition 
of the virtual and real partitions of VTAM. Figure 22-1 maps all the VTAM components 
contained in virtual storage. Similarly, Figure 22-2 maps all the components that reside 
in real storage. 
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Low Virtual 
Address 



r .j 

VTAM initial load area. This is the program that is loaded when VTAM 
is started. This area also contains the partition save area. 

(Component - LOADINIT) 



This is the GETVIS map that is built to manage the storage allocated 
from the partition. 

(Component -• STORMAP) 



Address table for modules loaded into the VTAM partition. 

(Component - ALOADTBL) 



VTAM pageable modules loaded from tne load list, 
packed in this space. 

(Component - VTMDDS) 



Tne working set is 



VTAM pageable buffer storage pools. (This area should be added only if 
PAGPOOLS are not to be taken from the SVA.) 

(Component - PAGPOOLS) 



VTAM pageable modules loaded from the module lists in tne skeleton 
DVTs. 

(Component - DVTMODS) 



VTAM modules loaded by the ATTACH function. 

(Component - ATCHMODS) 



VTAM tables loaded by SYSDEF. 

(Component - SYSALOAD) 



\r- 



Space reserved for the loading of TOLTEP modules. 

(Component - TOLTWKA) 



VTAM modules to be fixed in real storage. 

(Component - FIXDMODS) 



VTAM buffer storage pools to be fixed in real storage. 

(Component - FIXPOOLS) 



VTAM modules to be fixed in real storage. These modules are the I/O 
appendages. 

(Component - IOAPPEN) 



|. 

This space is reserved for EXCP buffers for the TRACE and LOAD/DUMP 
functions to be fixed in real storage. 

(Component - EXCPBUF) 

L 

Figure 22-1. VTAM Virtual Partition Map 
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Low Real 
Address 



VTAM modules that have oeen fixed in real storage, 
area precedes the first fixed module. 

(Component - FIXOMODS) 



Tne partition save 



VTAM buffer storage pools that have been fixed in real storage. 

(Component - FIXPOOLS) 



VTAM modules that have oeen fixed in real storage. These modules are 
the CE and ATTN appendages. 

(Component - IOAPPEN) 

EXCP buffers that have oeen fixed in real storage. 

(Component - EXCPBUF) 



Figure 22-2. VTAM Real Partition Map 



Figure 22-3 shows the calculation subject and the rel 
through D7). Most important, it shows the hierarchic 
The structure in some cases is such, tnat a string of 
completed before the desired value can actually be ca 
calculation for "RDT" (identified by D2) can only be 
tnrough D2.5 have been calculated, because these resu 
"RDT" calculation. It will be helpful to become fami 
by reading the individual work sheets and relating th 
reason of context. Work Sheet C3 is included after Wo 
the work sheets are performed in bytes, except where 



ated work sneet identifier (A 
al structure of the calculations, 
lower-level calculations must be 
lculated. For example, the 
started when the results of D2.1 
Its are required as part of the 
liar with the calculation structure 
em to Figure 22-3. Note that, for 
rk Sneet D7. All calculations on 
noted. 
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Figure 22-3. Hierarchical Structure of VTAM Storage Calculations 

Identifiers A, Bl, and 30 on, relate to the work sneet (WS.) 

To accurately determine VTAM storage requirements, it is necessary to have information 
about the installation in which VTAM will be operating. An outline of tne information 
required is as follows: 

1. TP hardware configuration (as determined by all NCP3EN decks and all LOCAL build 
decks) . 

a. Number and types of terminals 

(1) BASIC devices 

(2) Terminal components (for example, 1050 card reader) 

(3) 3270 devices, local and remote 

b. Logical units - remote and local 

c. Number and type of lines 

(1) Dial lines and number of dial digits and size of ID verification data 

(2) Non-Dial lines and number of poll characters 
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d. (Slumber and types of cluster controllers 

(1) SNA Controllers 

(2) Remote 3270 Controllers 

e. Message sizes 

2. Host system characteristics 

a. Is Network Solicitor included? 

0. Types and numoers of operator commands 

c. Number of application programs with OPEN ACBs 

d. Types of VTAM support for I/O 

(1) BASIC support 

(2) RECORD support 

(3) 3270 local and remote 

(4) User exits. 

e. Number of concurrent TOLTEP users 

f. Number of messages arriving at nost each second 
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Work Sheet A - VTAM Partition 

Calculations of sums A, B, C, and D below will enable you to determine the values to 
specify for the VTAM partition size (in the ALLOC and ALLOCR statements or commands 
and in the SIZE=parameter of the EXEC statement). 

Constant requirement for fixed storage 14, 336 

SUM A= 14^336 

ISTPATCH (if module ISTPATCH has been compiled with a patch area 

different from the IBM-supplied patch area, enter the size 

rounded up to a multiple of 128; if ISTPATCH Has not been 

modified, enter 128) . \ 

FIXPOOLS (from WS.B4) 

IOAPPN (from tfS.B2) 

Preliminary SUM B- 

After rounding preliminary SUM B up to 2048, SUM B= 

Constant requirement for pageable storage 684^032 

If SSS is to be run as a subtask, add the size indicated for the 

appropriate interactive or batch phase given under Module 23: SSS 

If BTP is to be run as a subtask, add the size required for BIP 

(see the BTP User's Guide) 

If NET30L=YES, enter 8192; if NO, enter 

Preliminary SUM C- 

After rounding the preliminary SUM C up to a multiple of 2048, SUM C= 

TOLTWKA (maximum number of current TOLIEP users x 34,816; see 

Note) 

SYSALOAD (from WS.B1) 

SMSBUF (from tfS.B3) 

PA3P00LS (from WS.B5) 

Preliminary SUM D= 

By rounding preliminary SUM D up to a multiple of 2048, SUM D= 

Calculation for ALLOC 

(SUM A + SUM B + SUM C + SUM D)/1024= 

Calculation for ALLOCR 

(SUM A + SUM B)/1024= 

Calculation for SIZE parameter in EXEC statement 

(SUM A + SUM 0/1024= 

Note: The maximum number of concurrent TOLTEP users is eguai to the maximum number 
of terminals requiring online diagnostic testing at one time. For small networks, 
this number will be small, probably 1. As the network grows in size, the number of 
terminals requiring concurrent online testing will increase to 2 or more. 
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Work Sheet Bl - Calculation of SYSALOAD 



This area is wnere SYSDEF loads certain tables to be used in building RDTs. rtie input 
for tie variables in the calculations should be taken from all Network Control Program 
generation decks, and all LOCAL and APPL statement decks for tne VTAM system. 

Enter the total number of names specified in the name 
fields of the following macros: 

PCCU macros 

3R0UP macros 

LINE macros (botn dial and non-dial) 

TERMINAL macros except for 2980s with two addresses 

specified 

TERMINAL macros for 2980s with two addresses specified 

(multiply by 2) 

COMP macros 

CLUSTER and PU macros 

INNODE macros 

DIALSET macros 

LU macros 

LOCAL statements 

APPL statements 

Value specified in LUPOOL macro 

TERMINAL macros followed by a COMP macro 

TERMINAL macros with CTERM=yES 

VBUILD statements 

LBUILD statements + 

SUM A = x 12 = 



If any SDLC devices are in the Network Control Program 
generation deck, enter 10; otherwise, 



+ 10 

SUM B = 



SUM B rounded up to a multiple of 128 = 

Enter sum of the sizes of all unique user-specified 

MODTABs 

Enter sum of the sizes of all unique user-specified 

USSTABs 

Enter sum of the sizes of all unique user-specified 

interpret tables + 

(Tables referenced more than once are counted only 

once. Derive the sum by rounding each table size up to 

a multiple of 128 and then sum up the rounded sizes.) SUM C = 

Enter number BHSET macros in Network Control Program 
generation decks 

x 

SUM D = 

SUM D rounded up to a multiple of 128 = 
SYSALOAD = 
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Work Sheet B2 - Calculation of IOAPPN 



This area is for the VT&M fixed I/O appendage. 

If there will be an activated Network Control Program 
in the VT&M system, enter 5760 

If there will be a local device activated in the VT&M 
system, enter 4992 

IOAPPN value = 



Work Sheet B3 - Calculation of SMSBUF 

Tnis area is needed by VTA.M storage management to 
maintain the variable storage pools. 

Enter the following: 

VPBUF (from tfS.C2) divided by 2048 



SUM A. rounded up to a multiple of 12( 
VFB.UF (from tfS.Cl) divided by 2048 = 



™4 

"72 



SUM h = 



„1 
___ 

"72 



SUM B = 



SUM B rounded up to a multiple of 128 

SMSBUF = 

Work Sheet B4 - Calculation of FDCPOOLS 



This area comprises the VTAM fixed buffer pools from 
which all fixed VTAM control blocks and I/O buffers are 
allocated. 

Enter bsz = (from tfS.C3) 

LF 

Enter bno = (from WS.C3) 
LF 

LFBUF = SUM A rounded up to a multiple of 128 

SFBUF 

Enter VFBUF (from tfS.Cl) 

FIXPOOLS= 



24 



x 

SUM A = 



128 
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Work Sheet B5 - Calculation of PAGPOOLS 

brio, bsz, and vbsz are calculated in Work Sheet C3. Each pool size total should be 
rounded up to a multiple of 128. 

VPBUF = vbsz = (from AS.C2) 

VP 

LPBUF = (bsz + 8) x bno = (from tfS.C3) 

LP LP 

SPBUF = (bsz + 8) x bno = (from tfS.C3) 

SP 3P 

APBUF = (bsz + 8) x bno = (from tfS.C3) 

AP AP 

tfPBUF = (bsz + 8) x bno = (from WS.C3) 

WP WP 

NPBUF = (bsz + 8) x bno = (from WS.C3) 

NP INIP 

PPBUF = (bsz + 24) x bno = (from WS.C3) 
PP PP 



SUM h 



PA3P00LS = SUM A rounded up to a multiple 
of 2048 = 
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Work Sheet CI - Calculation of VFBUF 



This area is the VThM variable fixed pool (VFBUF). 

Enter the total number of names specified in the 
name field of the following macros: 

For all 370x subareas - 

DIA.L3ET macros 

3R0UP macros 

LINE macros (dial and non-dial) 

TERMINAL macros (all kinds) 

VTERM macros 

COMP macros 

Value specifies in LUPOOL macro 

INNODE macros 

LU macros 

CLUSTER and PU macros 



+ 


2 






= 


X 


8 = 


+ 


SUM A. = 









16 



SNT value = SUM A rounded up to a multiple of 204: 
if SUM A. is greater than 2048; otherwise, it is 
SUM A 



For all local subareas - 
LOCAL macros 



+ 2 

= x 8 = 

+ 16 

SUM B = 



SNT value = SUM B rounded up to a multiple of 2041 
if SUM B is greater tnan 2048; otherwise, it is 
SUM B 

For all switched subareas - 

PU macros 
LU macros 



x 8 = 

+ 16 

SUM C = 



SNT value = SUM C rounded up to a multiple of 204i 
if SUM C is greater than 2048; otherwise, it is 
SUM C 
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For all 3790 local subareas - 

PU macros 
LU macros 



x 2 = 



x 8 = 

SUM D = 



16 



SNT value = SUM D rounded up to a multiple of 2048 
if SUM D is greater than 2048; otherwise, it is 
SUM D 

sisir = suyi A + SUM B + SUM c + SUM d = 

Maximum number of application tasks 

If NErS0L=YES, enter 1; otherwise, enter 



Maximum number of concurrently active Network 

Control Programs plus locally attached 3790 

clusters 

Maximum number of concurrently active 3270 LOCAL 

devices 

MAXSUBR. parameter on the BUILD macro in the 

Metwork Control Program generation deck rounded up 

to a power of 2 



x 48 = 

x 528 = 

x 160 = 



x 8 = 

+ 



16 



VFBUF=SUM E rounded up to a multiple 

Of 2048 = 

vbsz=7F 



SUM E = 



SUM F = 
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Work Sheet C2 - Calculation of VPBUF 



This area is the VTAM variable pageable buffer pool (VPBUF). 

SYSDEF work area size (from WS.D1) 

SYSDEF RDT size (from WS.D2) 

SRTADD size (from WS.D3) ~ 

PSStfKA size (from WS.DU) 

EPTDVT size _ii!36 

OPNCLS size (from WS.D5) _~ 

OPNAPPL size (from WS.D6) 

VARYSIZE (from WS.D7) 

+ 320 

SUM A = 
SUM B = SUM A x 1.10 = 

VPBUF = SUM B rounded up to a multiple of 2048 = vbsz^VP 



Work Sheet Dl - Calculation of SYSDEF Work Area 



This area is the part of VPBUF needed for the system definition 
(SYSDEF) work area. 

For a 370x r enter the largest value calculated for a 370x suoarea 
of a SYSDEF work area (from WS.D1.1). 

Otherwise, enter the largest of the following values: 

• the largest value calculated for a SYSDEF work area for a 3270 
LOCAL subarea (from WS.D1.2) 

• the largest value calculated for a SYSDEF work area for an 
APPL subarea (from WS.D1.3) 

• the largest value calculated for a SYSDEF work area for a 
switched subarea (from WS.D1.4) 

• the largest value calculated for a SYSDEF work area for a 3790 
LOCAL subarea (from WS.D1.5) 

SYSDEF work area size = 
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Work Sheet Dl.l - Calculation of SYSDEF Work Area for a 370x 



This calculation must be done for each Network. Control Program tnat will be active in a 
370x in trie VTAM network. The input for the variables in the calculations should oe 
taken from the Network Control Program generation deck. 

Network Control Program symbolic name = 

Enter the number of the following: 

PCCU macro 1 x 2 56 = 256 

DIALSET macros ~ x 80 = + 

SUM A = 



Subtotal A = SUM a rounde3 up to 2048 = 

Enter the total number of the following: 

GROUP macros x 92 = 

LINE macros with DIAL=NO x 116 = 

LINE macros with DIAL=YES x 160 = 

TERMINAL macros not followed by a COMP macro (not a 

2980) x 424 = 

TERMINAL macros followed by a ZOMP macro x 424 = 

TERMINAL macros for a 2980 ~ x 212 = 

VTERM macros ~ x 212 = 

COMP macros x 212 = 

LU macros x 176 = 

CLUSTER and PU macros for clusters on non-SDLC lines x 96 = 

CLUSTER and PU macros for clusters on SDLC lines x 148 = 

Value specified in LUPOOL macro x 84 = 

PU macros on SDLC dial lines x 84 = 

Innode macros x 160 = 

SUM B = 

Subtotal B = SUM B divided by 1881 (rounded up to a 
whole number) x 2048 = 

Enter the total number of the following: 

Unique VTDLIST macros referred to by a VIDSEQ 

parameter on a GROUP, LINE, or TERMINAL macro x 8 = 

VIDSEQ parameters on every referenced VIDLST macro x 5 = 

TERMINAL macros that specify DIALNO= that are on a 

3R0UP or LINE macro that specifies DIAL=yES and 

DIALSET= x 4 = 

Unique LCTYPE parameters for every MTALI3T macro 

referenced on a GROUP or LINE macro + 1 x 5 = 

Poll characters specified in the POLL parameter of 
all TERMINAL and COMP macros, and the GPOLL 
parameter of the CLUSTER macros 

Dial digits specified on the DIALNO parameter of all 
TERMINAL macros where the LINE or GROUP macro 
specified CALL=OUT or INOUT 

BHSET macros x 9 = + 

SUM C = 
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Enter the number of the following: 



VIDSEQ parameters for the VIDLIST macro with the 
largest number of VIDSEQ parameters x 5 



LCTYPE parameters for the MTALIST tiacr'o with the 
largest number of LCTYPE parameters x 5 



Enter calculated value of 



SYSDEF work area for a 370x subarea = 



+ 
SUM Cl= 



+ 
SUM C2 = 



Poll characters from above SUM C3 = 

Dial digits from above SUM C4 = 

BHSET macros from above SUM C5= 

SUM d = 2024 - the largest of SUM CI, C2 f C3, 

C4, or C5 SUM D = 

Subtotal C = SUM C divided by SUM D (rounded up 
to a whole number) x 2048 = 

Enter ttie total number of the following: 

VIDLIST macros x 36 = 

VIDSE2 parameters on all VIDLIST macros x 44 = 

MTA.LIST macros x 52 = 

MTA.LCST macros x 20 = 

SUM E = 

Subtotal D (rounded up to a multiple of 2048) = 



+ 10240 
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Work Sheet D1.2 - Calculation of SYSDEF Work Area for a 3270 LOCAL Subarea 



This calculation must be done for every LOCAL subarea that will be active in tne VTAto 
network. The input for the variables in the calculations should be taken from its 
definition statement deck. 

Enter the number of LOCAL statements x 296 = 

+ 136 

SUM A = 

Subtotal A - SUM A divided by 1813 (rounded up to a 

whole number) x 2048 = 

+ 1221 

SYSDEF work area for a LOCAL subarea = 

Work Sheet D1.3 - Calculation of SYSDEF Work Area for an APPL Subarea 



This calculation must be done for every APPL subarea that will be active in the VTAVi 
network. The input for the variables in the calculations should be taken from tne APPL 
statement decks. 

Enter the number of APPL statements x 120 = 

+ 136 

SUM A = 



Subtotal A = SUM A divided by 1905 (rounded up to a 

whole number) x 2048 = 

+ 12281 



SYSDEF work area for an APPL subarea = 

Work Sheet D1.4 - Calculation of SYSDEF Work Area for a Switched Subarea 

This calculation must be done for every bwitched subarea that will be active in tne VTAM 
network. The input for the variables in the calculations should be taken from its 
definition deck. 

Enter the number of: 

VBUILD statements x 156 = 

PU macros ~ x 14 8 = 

LU macros x 176 = 



136 



SUM A = 



Subtotal A = SUM A divided by 1849 (rounded up to a 
whole number) x 2048 = 

SYSDEF work area for a switched subarea 



+ 10240 
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Work Sheet D1.5 - Calculation of SYSDEF Work Area for a 3790 LOCAL Subarea 

rtiis calculation must be done for every 3790 subarea that will be active in the VTAM 

network. The input for tne variables in the calculations should be taken from its 
definition deck. 

Enter the number of: 

VBUILD statements x 144 = 

PU macros x 236 = 

LU macros x 176 = 



136 



SUM A = 



+ 10240 



Subtotal A = SUM A divided by 1850 (rounded up to a 
whole number) x 2048 

SYSDEF work area for a 3790 subarea = 



Work Sheet D2 - Calculation of SYSDEF RDT Size 



This area is the part of the VPBUF needed for Resource Definition Tables (RDTs) tnat 
are built by SYSDEF for the subareas - 370x, APPL, 3270s LOCAL, 3790s LOCAL, and 
switched. 

Enter the sum of the sizes of all the RDTs for: 

370x subareas (from WS.D2.1) __ 

3270 LOCAL subareas (from W5.D2.2) _[ 

APPL subareas (from WS.D2.3) _] 

Switched subareas (from WS.D2.4) 

3790 LOCAL subareas (from W3.D2.5) +_~ 

SYSDEF RDT size = 
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Work Sheet D2.1 - Calculation of the RDT for a 370x Subarea 



This calculation must be done for every Network Control Program that will be active in a 
370x in tne VTAM network. The input for the variables in the calculations should be 
taken from the Network Control Program generation deck. However, most of the variables 
can be taken from tfork Sheet Dl.l. 



Network Control Program symbolic name = 
Enter the total number of: 



PCCU macro 

DIALSET macros 

GROUP macros 

LINE macros with DIAL=NO 

LINE macros with DIAL=YES 

TERMINAL macros not followed by a COMf macro 

(not a 2980) 

TERMINAL macros followed by a COMP macro 

TERMINAL macros for a 2980 

VTERM macros 

COMP macros 

INNODE macros 

LIJ macros 

CLUSTER macros for clusters on non-SDLC lines 

CLUSTER macros for clusters on SDL" lines 

Value specified in LUPOOL macro 

PU macros on SDLC dial lines 



1 X 


256 


= 


X 


80 


- 


X 


92 


= 


X 


116 


= 


X 


160 


= 


X 

X 


212 

424 


= 


X 


424 


= 


X 


212 


zz 


X 


212 


= 


X 


160 


= 


X 


176 


= 


X 


96 


= 


X 


148 


= 


X 

X 


84 
34 


= 



256 



Unique VTDLIST macros referred to by a VIDSEQ 
parameter on a GROUP, LINE, or TERMINAL macro 

VIDSEQ parameters specified on all referenced 
VIDLIST macros 

TERMINAL macros that specify DIALNO= and that are on 
a GROUP or LINE macro that specified DIAL=YES and 
DIALSET= 

LCTYPE parameters specified on all unique MTALIST 
macros referenced by a GROUP or LINE macro + 1 

Poll cnaracters specified on the POLL parameter of 
all TERMINAL and COMP macros and the GPOLL parameter 
of the CLUSTER macro 

Dial digits specified on the DIALND parameter of all 
TERMINAL macros where the LINE or GROUP macro 
specified CALL=OUT or INOUT 
BHSET macros 



8 = 



5 = 



5 = 



RDT size for 370x subarea = SUM A rounded up to a 
multiple of 2048 if SUM A is greater than 2048; 
otherwise, enter SUM A 



SUM A = 
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Work Sheet D2.2 - Calculation of the RDT for a 3270 LOCAL Subarea 

This calculation must be done for every 3270 LOCAL suoarea tnat will be activated in tne 
VTAM network. The variable was determined for Work Sheet Dl-2. 

Symbolic name = 

Enter numDer of LOCAL statements x 296 = 

+ 152 

SUM A - 

RDT value for LOCAL subarea = SUM A rounded up to a 
multiple of 2048 if SUM A is greater than 2048; 
otherwise, enter SUM A 



Work Sheet D2.3 - Calculation of the RDT for an APPL Subarea 

This calculation must be done for every APPL subarea that will oe active in the VTAM 
network. The variable can be taken from Work Sheet Dl.3. 

Enter number of APPL statements x 12 = 

+ 152 

SUM A = 



RDT value for APPL node = SUM A rounded up to a 
multiple of 2048 if SUM A is greater than 2048; 
otherwise, enter SUM A 

Work Sheet D2.4 - Calculation of the RDT for a Switched Subarea 

This calculation must be done for every switcned subarea that will be activated in tne 
VTAM network. The variables for this calculation can be taken from Work Sheet Dl.4. 

Enter the number of: 

Unique MAXNOs x 33 = 

Unique MAXSRPs 
VBUILD macros 
PU macros 
LU macros 
PATH macros 



RDT value for a switched subarea = SUM A rounded up to 
a multiple of 2048 if SUM A is greater tnan 2048; 
otherwise, enter SUM A 



x 8 


= 




x 156 


= 




x 148 


= 




x 176 


= 




x 8 




+ 152 


SUM A 


= 
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Work Sheet D2.5 - Calculation of the RDT for a 3790 LOCAL Subarea 

This calculation must be done for every 3790 subarea that will be activated in the VTAM 
network. The variable can be taksn from Work Sneet Dl.5. 



Enter trie number of: 

VBUILD macros 
PU macros 
LU macros 



RDT value for a 3790 subarea = SUM A rounded up to a 
multiple of 2048 if SUM A is greater than 2048; 
otherwise, enter SUM A 



Work Sheet D3 - Calculation of SRTADD 



X 144 = 
x 236 = 
x 176 = 

SUM A = 



152 



Tnis area is the part of VPBUF needed for the symbol resolution table (SRD directory 
and trie SRT entries. The information needed for this work sheet can be taken from 
Work Sneets Dl.l through Dl.5. 

Enter trie total number of names specified in the name 
fields of the following macros: 

PCCU macros 

DIALSET macros 

3R0UP macros 

LINE macros (both dial and non-dial lines) 

TERMINAL macros (all types of terminals) 

VTERM macros 

COMP macros 

INNODE macros 

LU macros 

CLUSTER and PU macros ~_ 

BHSET macros 

LOCAL statements 

APPL statements 

VBUILD statements 

LBUILD statements 



SUM A = 



48 



6144 



SRTADD size = 
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Work Sheet D4 - Calculation for PSSWKA 

This area is the part of VPBUF needed for PSS control blocks. 
Enter maximum number of concurrent application tasks 
If NETSOL=YES is specified, enter 1; otherwise, 

PSSWKA size = 



x 912 



Work Sheet D5 - Calculation of OPNCLS 



This area is the part of VPBUF needed for VTAM control blocks to support OPNDST 
processing. Estimate a worst case condition for the number of concurrent OPtSiDSTs (that 
is, a combination of various types of OPNDSTs that requires the most storage) . Using the 
worst case estimate will allow adequate VPBUF space for processing of any combination of 
OPNDST macro instructions. 



Enter the maximum of concurrent OPNDST macros 

Of the concurrent OPNDST macros, enter: 

Number of NIB list entries if there is more than one 
NIB in the list 



Of the concurrent OPNDST macros, enter 
total size of LOGON data 

Of the concurrent OPNDST macros, enter 
number of logical units (LUs) 



OPNCLS size = 



912 = 



16 = 



16 



SUM B = 



56 = 



+10648 



Work Sheet D6 - Calculation for OPNAPPL 



This area is the part of VPBUF needed for VTAM control blocks to support application 

programs. 

Enter maximum number of OPEN ACBs that will be in the 

VTAM system 

If NEISOL=YES is specified, enter 1; otherwise, 



SUM A = 



x 608 

+ 376 



OPNAPPL size = 
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Work Sheet D7 - Calculation for VARY 



Enter number of PU statements with ISr&rus=ACriVE 



x 4656 = 



Work Sheet C3 - DOS/VS Storage Pool Formulas for bth, bno, and bsz 



• Formulas for bth calculation 

APBUF: NLU+NSSTERM+NBSCTERM+NLOC3270+5 

LPBUF1: NPORT+(2*NSDLCCHJS) + (2*NLDC3790+ NCOMMANDS+NLOC3270 +NBSCCLUS 

NPBUF: N370X+NPORT+NLU+NBSCCLUS+NL3C3270+ NSDLCCLUS+NLOC3790 
(See Note 1) 

PPBUF2: (NLa+NSSTERM+NBSCTERM+NLOC3270>*2 
(See Note 2) 

SPBUF: NPORT+ (2 + NSSTERM) + (3*NBSCrERIVi) + (2*NLOC3270) +NBSCCLUS+ (2*NLU) + 
(4*NTRANX)+NrOLrEP+NSDLCCLUS+ NLOC3790+N&CB+NCOMMANDS 

tfPBUF: NLO+NSSTERM+NBSCTERM+NLOC3270+ (2+NTRACE) 

SFBUF: 1 

LFBUF: / NrRANX*NB0PMSG\+[NTR»VNX*S4AXBFR[J+2MAXBFRu\ + /NrRAdX*MAXBFt4U+2MAXBFRu\ + l 

\ L3270 / \ L3790 L3790 L3790 / \l370x L370x L370x / 

• Fornulas for bno and bsz Calculation 

| J AP | LP j | NP j PP J SP j WP J SF | LF | 

|.___X X x x x x x x ^ 

1 bno | bth | bth | bth | bth | bth | bth | 1 j bth+2*/.2MAXBFRU + SMAXBRFU+NBUFiyiSG \ | 

j 1 | | | | - 90 | | [ V L370x L3790 ) | 

y x-___x x x + x x x _ ^ 

| bsz | 48 | 608 | 264 |LFBUF|104 |264 | - (see "Formulas for LBBUF osz Calculation" | 
I I I I I bsz | | | [ [ 

L X J. X X X X X X J 
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Variables for F ormulas 

NBSCTERM - Number of remotely attached terminals on BSC lines (number of TERMINAL and 
COMPONENT macros associated with BSC lines). 

NBSCCLUS - Number of remotely attached 3271, 3275, and 2972 clusters on BSC lines. 

NLOC3270 - Number Of locally attached 3270 terminals (count eacn printer and display 
station separately) . 

NLO" - Number of logical units (numoer of LU macros). 

NPORT - Number of dial-up switched lines. 

MAXBFRU - Parameter specified on 370x and 3790 definition decks. 

2MAXBFRU means the sum of all values if tnere is more than one local 370x or 
3790 active. 

NBUFMS3 - Number of elements required to read the full screen of a 3277 display 

station. Use LFBUF bsz value (from Work Sheet Dl.l) to select NBUFMS3 from 
one of the following two tables. Index into the table to the bsz value 
closest to the LFBUF bsz. 



r t 1 

| Read Full, 3277 Model l|Read Full, 3277 Model 2 | 
j. T + T ., 

[bsz value | NBUFMSG | bsz value | NBUFMSG | 
y + + + 1 



96 


16 


216 


8 


632 


4 


960 


2 


952 


1 



| 104 | 4 | 96 | 16 | 

| 256 | 2 | 216 | 8 | 

| 632 

I 

I 

l x j. j. : j 

If both Models 1 and 2 are attached, use the Model 2 table. 

NSDLCCLUS- Number of remotely attached cluster controllers on SDLC lines. 

NSSTERM - Number of remotely attached terminals on start-stop lines (number of TERMINAL 
and COMPONENT macros associated witn start-stop lines) . 

NTOLTEP - Number of concurrent TOLTEP users. 

NTRANX - Number of transactions per second (where a transaction is one inbound message 
and one outbound message) - oetween the host and tne involved devices. 

N370x - Number of IBM 3704 and 3705 locally or remotely attached communications 
controllers. 

NETSOL - 1 if NETSOL=¥ES, otherwise 0. 

NTRACE - Number of terminals or LUs for which a VTAM buffer trace (TYPE=BUF) will be 
started. 

NLOC3790 - Number of channels for locally attached 3790 (PU macros for 3790s). 

NACB - Number Of OPEN ACBs. 

NCOMMANDS- Number of concurrent operator commands. 

Note 1 - There could be hidden levels as in a vary act, tne NCP wnich also activates 
all devices with ISTATCJS ACTIVE. 

Note 2 - Two represents the default BUFLIM, BUFACT product. For oaten this number 
could be low. The formula can be replaced by the sum of all the BUFACT * 
BUFLIM products. 
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Formulas for LFBUF bsz Calculation 



Depending on the installation's device usage, choose an initial bsz from the following 
overview. 



bsz = 
LF 



j Device Support 



jbsz Calculation 



|. + < 



Local 3270 | If the installation contains only local 3270s, calculate 

| bsz as tne average message length for 3277 display 
1 stations. 

j _ _ 


^ _ — _- _ 

370x |bsz must equal the ONITSZ operand on tne NCP HOST macro. 

j j If multiple N2Ps are active concurrently, UdIITSZ must nave 

| the same value for each WCP. 


3790 local only. Large | bsz = 1978 

batch transmission only. j 

j MAXBFRU = 1 
| 3790L 


3790 local only. Normal | bsz = 288 

transmission. j 

| MAXBFRU = 1 
J 3290L 


_ .j. _ — — — 

If priority is assigned to ajbsz = 370x bsz 
370x which is used with a | 
3790 local. | 

With 370x given priority, j j MAXBFRU = 1 for normal transmiseion 

3790 large batch performance) 3790L 

may be less efficient | 

because of multiple buffer j MAXBFRU = 1978 divided by (bsz -28) 

usage, and the 3790 may use | 3790L 

more storage than necessary j 

because of the priority beenj rounded up to a whole number for large batch 

given to the 370x. j transmission. 

_x - . — — __ _ _ 


f — - - — - - 

If priority is assigned to a|bsz = 1978 for large batch transmission. 

3790 local which is used j 

with a 370x. jbsz = 288 for normal transmission. 

With a 3790 local given | MAXBFRU = 1 
priority, 370x buffers may | 3790L 
not optimize storage. j 



l X - J 
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Constant requirement 

NETSOL (NETSOL=NO) 

SYSALOAD (from tfS.Bl) 

SMSBUF (from WS.B3) 

TOLIWKA (zero TOLTEP user»t 

ISTPkrCH (IBM-supplied patch area was not modified) 

FIXPOOLS (from WS.B4) 

IOAPPN (from WS.B2) 

PA3P00LS (from tfS.B5) 

VTAM Virtual Partition Si*e 

ALLOC = SUM A. divided by 1024, rounded up 



698368 



256 

384 

g 

128 

2944 

5760 

.^9632 

SUM h = 777072 

760K 



Figure 22-4. Sample Calculation for ALLOC Macro Instruction 



Constant requirement 

ISTPATCH (IBM-supplied patch area was not modified) 

FIXPOOLS (from WS.B4) 

IOAPPN (from WS.B2) 

VTAM Real Partition Size 

(rounded up to a multiple of 2048) 

ALLOCR = SUM B divided by 102%, rounded up 



_!!£336 

128 

2944 

5760 

SUM A = _23168 
SUM B = 724576 

24K 



Figure 22-5. Sample Calculation for ALLOCR Macro Instruction 
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VTAM Components 

Core_l2a^e_Librar£_Rec[uirements 

r t 1 

| Phases | Blocks | 

h + j 

I | 181 | 796 | 

I I 15* I 16 ! 

" L X J 

* transients 

Pnases 

ISTAISIR 
ISTAICPT 

IISTAICTN 
ISTAICST 

ISTA.PC33 
ISTA.PC35 
ISTAPC36 
ISTAUCA3 
ISTAUCA^r 
ISICRCR" 
ISTCSCMR 

isroccoo 

ISTDCC02 

isrDccio 

ISTDCC11 
ISTDCC12 
ISTDCC13 

isrbcc2.o 
istdcc:21 

ISTDC222 
ISTDCC23 
ISrDCC24 
ISTDCC25 
ISTDCC30 
ISTDCC31; 
ISTDCC32 
ISTDCC35 
ISTDCCUO 
ISTDCC41 
ISrDCCl*2 
ISTDCC50 
ISTDCC51 
ISTDCC60 
I5rDCC61 
ISTDC280 
ISTDCC81 
ISTDCC85 
ISTDVCBk 
ISTDVCRC 
ISrESCOl 
ISTESC02 
ISTINCDP 
| ISTINCDT 
ISTINCFE 
ISTINCFO 
ISTINCF1 

istincip 
i istinclm 

istincms 

| ISTINCN2 

ISTINCVr 
ISTINCXM 



istinczi 

ISTINCZ2 

ISTMMCHS 
ISTNMCCk 
ISTNMCCB 
ISTNMCCF 
ISTNMCCI 
ISTMMCCO 
ISTNMCCR 
ISTNMCC3 
ISTNMCCT 
ISTNMCCZ 
ISTNMC1S 
ISTNMC2S 
ISTNM23S 
ISTNMC4P 
ISTNMC4S 
ISTNMC5P 
ISTNMC53 
ISTNMC6P 
ISTNMC6S 
ISTNMC7P 
ISTNMC7S 
ISTNMC8P 
ISTNMC9P 
ISTNSCOO 
ISTOCCCA 
ISTOCCCB 
ISTOCCCD 
ISTOCCDF 
ISTOCCOA 
ISTOCCOB 
ISTOCCRr 
ISTOCCSk 
ISTOLTEP 
ISTORCBP 
ISTORCGS 
ISTPATCB 
ISTPICBA 
ISTPICCE 
ISTPICCF 
ISTPICCI 
ISTPICCO 
ISTPICCS 

isrpiccr 

ISTPICCU 
ISTPICDD 
ISTPICDR 
ISTPICGI 
ISTPICGP 
ISTPICGR 
ISTPICIN 

isxpicir 

ISTPICL& 
ISTPICLC 
ISTPICLT 
ISTPICMA 
ISTPICQP 
ISTPICSC 
ISTPICSO 
ISTPICSS 
ISTPI2ST 
ISTPICSU 
ISTPICTF 
ISTPICTH 
ISTPICTO 
ISTPICTR 
ISTPICXk 
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ISTPICXF 
ISTPICXI 
ISTPICXL 
ISTPICXO 
ISTPICXI 
ISTPICX2 
ISIPICX8 
ISTPIEBI 
ISTPIEBO 
ISTPIECP 
ISTPIEIF 
ISTPIEIR 
ISIPIEIS 
ISTPIELF 
ISIPIELO 
ISTPIELS 
ISTPIEPA. 
ISTPIEPB 
ISTPIEBC 
ISTPIERF 
ISTPIERO 
ISTPIESA 
ISTPIESG 
ISTPIESI 
ISTRACCA 
ISTRACCR 
ISIRACTB 
ISTRACTM 
ISTRAEL3 
ISTECCYO 
ISTRCC21 
ISTRCC22 
ISrRCC!23 
ISTRCC26 
ISTRCC30 
ISTRCC51 
ISTRCC52 
ISTRCC53 
ISIRCC54 
ISTRCC63 
ISTRCC65 
ISTRCC80 
ISrRCC81 



ISTSC034 

ISTSDCAL 
ISTSDCCA 
ISTSDCCD 
ISTSDCCF 
ISTSDCCN 
ISTSDCCR 
ISTSDCOD 
ISISEC01 
ISTSEZIO 
ISTSEC21 
ISTSEC30 
ISTSEC40 
ISTSEC51 
ISTZCLUS 
ISTJfCONr 
ISTYPSOL 
ISTXSSCP 

Y£AM 2£S£e 

PDAIDVTT 
PDAIDVTW 



ZlL^BSients 

$$ABERV1 
$$ABERV2 
$$ABERV3 
$$ABERV4 

| $$ABEBV5 
$$ABERV6 

| $$ABEEV7 

$$bcstoi 

$$BCST02 
$$BOST01 
$$BOST02 
$$BSTCNL 
$$BSTCN1 
$$RAST14 
$$RAST15 
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Relocatable Li brar ^R equ irements 



Modules 



Blocks 



504 



4,636 



Module 
Name 



Descriptions 



IJBESMRN 
IJBEVRN5 
IJBE3705 
ISTAICCK 
ISTAICIR 
ISTAICPT 
ISTAPCAS 
ISTAPCSH 
ISTAPCST 
ISTAPC33 
ISTAPC35 
ISTAPC36 

istauc&s 
istaucat 
isrccoio 

ISTCC011 
ISTCC012 
ISTCC013 

isrccoiu 

ISTCC015 
ISTCC016 

ISTCFCCE 
ISTCFCCS 
ISTCFCDP 
ISTCFCIN 
ISTCFCMM 
ISTCFCPC 
ISTCFCPO 
ISrCFCRP 
ISTCFCR1 
ISTCFCR2 

istcfcss 
istcfcsw 
isrcFcsi 

ISTCFCS2 

istcfctm 
istcfcxs 

ISTCRCR4 

isrcscAc 

ISTCSC&0. 

isrcsccL 

ISTCSCL3 
ISTCSCMR 
ISTCSCPS 
ISTCSCRL 
ISTDCCOO 
ISTDCC02 
ISTDCC10 

isrDccn 

ISTDCC12 
ISTDCC13 
ISTDCC20 
ISTDCC21 
ISTDCC22 
ISTDCC23 



Summarize 3705 MDR Records 

Edit and Print 3705 MDR Records 

Edit and Print Page Header for 3705 MDC Records 

API Check Routine 

API Interface Routine 

User Completion 

PSS Scheduler 

PSS Macro Services Routine 

PSS-TPIO Specifics - asynchronous process routine 

PSS TPUNLOCK 

PSS TPLOCK - Shared 

PSS TPLOCK - Exclusive 

Accounting Exit Routine 

Authorization Exit Routine 

TOLTEP - OLT Scheduler 

TOLTEP - Message I/O 

TOLTEP - Trace Return Code Handler 

TOLTEP - Loader 

TOLTEP - Resource Manager 

TOLTEP - Table Search Routine 

TOLTEP - READ/WRITE Exit 

System Writer Channel Appendage 

Operator Control Command Processor 

CTLPT - Display Command 

Operator Control Initialization 

Message CSECT 

POI Termination Routine 

POI Initialization Routine 

POI Reply Processor 

RCVCMD Processor 

POI Message Build and Purge Routine 

System Writer SVC 

System Writer I/O Process 

SENDCMD Router 

POI Vary, Display, and Modify Processor 

TPMSG Macro Handler 

STXIT OC for System Writer 

Feedback Routine 

Accept 

Acquire 

Cancel 

Logon 

Master Router 

Pass 

Release 

Request Start 

Request Finish 

Solicit LDO Request Processor 

Read LDO Request Processor 

Write LDO Request Processor 

Reset LDO Request Processor 

Solicit Macro Request Processor 

Receive Macro Request Processor 

Write Macro Request Processor 

Reset Macro Request Processor 
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Module 
Name 



Descriptions 



ISTDCC24 
ISTDCC25 
ISTDCC30 
ISTDCC31 
ISTDCC32 
ISTDCC35 
ISTDCC40 
ISTDC241 
ISTDCC42 
ISTDCC50 
ISTDCC51 
ISTDCC60 
ISTDCC61 
ISTDCC80 
ISTDCC81 
ISTDCC85 
ISTDVCBA 
ISTDVCRC 
ISTEC000 
ISTEC123 
ISTEC456 
ISTEC789 
ISTESC01 
ISTESC02 

isncooo 

XSTIC001 
ISTIC002 
ISTIC:003 

isricooo 

ISTIC005 

istincad 
istincal 
istincav 
istincaw 
istincao 

ISTIN2BL 
ISTINCBS 
ISTINCCC 
ISTINCCF 
ISTINCCL 
ISTINCDL 
ISTIHCDP 
ISTINCDT 
ISTINCDO 
ISTINCDO 
ISTINCD1 
ISTINCD2 
ISTINCD3 
ISTINCDU 
ISTINCD5 
ISTINCD6 
ISTINCD7 
ISTINCD8 
ISTINCD9 
ISTINCEO 
ISTINCE1 
ISTINCE2 
ISTINCE3 
ISTINCEO 
ISTINCE5 
ISTINCE6 
ISTINCE7 
ISTINCE8 
ISTINCE9 



Solicit All Macro Request Processors 

Read Any Macro Processor 

Feedback Start 

Analyzer 

Feedback Finish 

Pageable Extension of Feedback Start 

Solicit and Read LDO Feedback 

Write LDO Feedback 

Reset LDO Feedback 

Solicit, Read, if rite Feedback 

Reset Feedback 

Input Buffer Move 

Fixed to Pageable Move 

Purge Outbound 

Purge Inbound 

Read Any Purge 

Skeleton DVT for Basic 

skeleton DVT for Record 

TOLTEP - End of fOLTEP 

TOLTEP Message ft*t (100-399) 

TOLTEP Message Jmwt (400-699) 

TOLTEP Message text (700-999) 

Execution sequence Controller 

DVT Name Resolution 

TOLTEP - Resident Exit Initialize 

TOLTEP - Test Initialize 

TOLTEP - Communication Interval 

TOLTEP - Device Decode 

TOLTEP - Test Decode 

TOLTEP - Option Decode 

ADELETE Service Routine 

ALOAD Service 

Allocate/Deallocate Subroutine 

VTAM Task Control 

Subtask ATTACH 

BLDL Routine 

SVC Bootstrap Routine 

Start command Processor 

Loading Routine 

Error Recovery Processor 

Dump/Load Restart 

Dump/Load SuDtask 

Default USS Defiiition Table 

DVT Unload 

Subtask Detach 

Dial Out Processor 

Dial Failed Processor 

Offhook 1 

Select Path 

Dial Link Start 

Dial Allocate 

Dial Deallocate 

Dial Post 

Offhook 2 

Dial Out Start 

Link Restart I/O 

PAB Switch I/O 

PU Cleanup 

Link Restart 

Dial Give Resources 

Dial Hangup 

Inop Processor 

Dial Link Completion 

Potential Tailor* 
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Module 
Name 



■+■ 



Descriptions 



ISTINCFE 
ISTINCFM 
ISTINCFS 
ISTINCFO 
ISTINCF1 
ISTINCF3 
ISTINCF4 
ISTINCF5 
ISTINCF9 
ISIINCflA 

istinchi 
isiincib 
istincio 
istincip 
istincii 
istinclf 

ISTIflCLM 
ISTINCLO 
ISTINCL1 
ISTINCL2 
ISTINCL3 
ISTINCL4 
ISTINCL5 
ISTINCL6 
ISTINCL7 
ISTINCL8 
ISTINCMD 
ISTINCMR 
ISTINCMS 
ISTINCMY 
ISTINCNS 
ISTINCNO 
ISTINCN2 
ISTINCN8 
ISTINCOC 
ISTINCOE 
ISTINCOI 
ISTINC02 
ISTINCOS 
ISTINCPD 
ISTINCPH 
ISTIMC2B 
ISTINC2E 
ISTINCRD 
ISTINCRF 
ISTINCRP 
ISTINCRR 
ISTINCRS 
ISTINCRl 
ISTINCR2 
ISTINCR3 
ISTINCR4 
ISTINCRS 
ISIINCR6 
ISTINCSD 
ISTINCSH 
ISTINCSM 
ISTINCS1 
ISTINCTE 
ISTINCTM 
ISTINCTE 
ISTINCUA 
ISTINCUB 
ISTINCUM 



Front End Processor 

FSS Function Manager 

Segment Deletion 

Fixed Module Linkage 

FSS Bequest/Response Construction 

Init SELF Processor 

TERM SELF Processor 

Stop, Modify CIB Processor 

Stop/Modify Processor 

Host Attachment Routine 

Halt Command Processor 

STAE Routine 

I/O Command Scheduler 

SCP Inbound Processor 

Initialization Control 

Logon Processor 

Default Logon Mode Table 

Activate Direct Attachment Node 

Activate PU - Local Subarea 

Local Attach - Dial Start 

Local Attach - Offhook 1 

Local Attach - Offhook 2 

Local Attach - Dial Failed 

Local PU Cleanup 

Local Abandon Connection 

Deactivate Direct Attachment Node 

Modify Router 

Master Router- 

TOLTEP/VTAM Interface 

OSS Portion of SSCP Master Router 

Network solicitor Attach 

DTF Builder 

Device Allocation SVC 

Activate Reserved 

TERM NOP 

Operator Termination 

Operator Task Initialization 

Operator 2uery 

Optional Services Routine 

Buffer Pool Initialization 

Parameter Handling 

2AB Initialization 

2uiesce 

Parameter Read Routine 

Modify Command Router 

Communications Controller ERP Reload 

Resource Release 

Read Record 

Configuration Restart Control 

Configuration Restart/Vary Interface 

NCP Configuration Reset 

VSAM I/O C/R Data Set 

Interface to DLR 

VSAM I/O-Active NODELST Data Set 

Task Communication Routine 

Search Logon Mode Table 

SSCP Session Monitor 

Status Feedback Router 

TPEND Exit Scheduler 

Timer Routine 

Trace Control 

Verb and Keyword Processor II 

Verb and Keyword Processor III 

USS Function Manager 



336 DOS/VS System Generation 



Modul; 
Name 



Descriptions 



ISTINCUQ 
ISTINCUO 
ISTINCU1 
ISTINCU2 
ISTINCU3 
ISTINCU4 
ISTINCU5 
ISTINCU6 
ISTINCU7 
ISTINCU8 

istiisicva 
istimcvi 
istincvn 

ISTItfCVO 

isiincvp 
istinzvs 
istincvx 

ISTINCV1 
ISTINCV2 
ISTINCV3 
ISTINCV4 
ISTINCV5 
ISTINCV6 
ISTINCV8 
ISTINCV9 
ISTINCWT 
ISTINCWO 
ISTINCW1 
ISTINCW2 
ISTINCW3 
ISTINCW4 
ISTINCS5 
ISTINCW6 
ISTINCH7 
ISTINCW8 
ISTINCW9 
ISTINCXM 
ISTINCXO 
ISTINCX1 
ISTINCX2 
ISTINCX3 
ISTINCX6 
ISTINCX7 
ISTINCX8 
ISTINCX9 
ISTINCXO 
ISTINCYI 
ISTINCY3 
ISTINCY4 
ISTINCY5 
ISTINCZl 
ISTINCZ2 
ISTINC01 
ISrINC02 
ISTIUC03 

isnisicos 

ISTIMC06 
ISTINC07 
ISTINC32 



USS Quota Deletion 

Input Media Control 

SCS Input Media Control 

USS Character String Translation 

Verb and Keyword Processor I 

USS Logon Processor 

USS Logoff Processor 

USS Status Feedback Processor 

3270 Output Media Control 

USS Output Media Control Processor 

Vary Activate 

Vary Deactivate 

RNAME/CUA Processor 

Vary Session Initialization 

Vary Deactivate phase II 

Vary Activate Extension 

Vary Deactivate 

VIAMRP Task 

Answer Mode Handler 

VARY INOP Command Processor 

Activate PU Switched Subarea 

Activate LU Switched Subarea 

SEND/SEND FMD Processor 

IPL/DUMP Processor 

Contact/Discontact Processor 

VTAM Thread Dispatcher 

OPNDST Processor 

TOLTEP Attach and NETSOL Delete 

Hang-up I/O 

Obtain/Free NCSPL 

Contact Processor 

Discontact Processor 

Vary Pending Cleanup 

Build PABs 

Activate PU and LU 

VARY Path Processor 

3704/3705 Dump I/O Routine 

Deactivate Switched SDLC Links 

Deactivate Switched and Local PU 

Break Connections 

Switched/Local Header Deactivation 

Dial Fail Notify 

DACTPU Handler 

PAB Purge 

CLSDST Handler 

APUNS Command Processor 

APUNS Transmission Services I/O Executor 

APUNS Command Completion Processor 

RTGOH Request Processor 

Disconnection Processor 

DTFSF 

DTFDA 

Load Utility Message and End 

DVT Preload Routine 

Communications Controller Load Input 

Communications Controller Load Initialization 

Load Utility Common Storage Area 

Communications Controller Load Output 

Communications Controller Load Output 
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Module 
Name 



Descriptions 



ISTINEXI 
ISTLINK1 
ISTLINK2 
ISTLINK3 
ISTLINK4 
ISTLINK5 
ISTLINK6 
ISTLINK7 
ISTLINK8 
ISTMMCHS 
ISTNMCCk 

istnmccb 
istnmccf 
istnmcci 
istnmcco 
istnmccr 
istnmccs 
istnmcct 
istnmccz 

ISTNMC1S 
ISTNMC2S 
ISTNMC3S 
ISTNMC4P 
ISTNMC4S 
ISTNMC5P 
ISTNMC5S 
ISTNMC6P 
ISTNMC6S 
ISTNMC7P 
ISTNMC7S 
ISTNMC8P 
ISTNMC9P 
ISTNSCOO 
ISTOCCCA 
ISTOCCCB 

isrocccc 
istocccd 
istocccb 
istocccl 
istocccm 
istocccn 
istoccdf 
istoccfb 
istoccfd 
istoccfo 
istoccfr 
istoccld 
istoccmd 
istoccnv 
istoccda 
istoccdb 
isroccoc 

ISTOCCOD 
ISTOCCOE 
ISTOCCDF 
ISTOCC2U 

ISTOCCRD 
ISTOCCRL 
ISTOCCRr 

istoccsa 
istoccsd 
istoccsl 
istoccur 
istorcbp 



Link Scripts 



Network Control Program 

Control Block Manipulation Routine 

Start Control Outbound 

Start Control Inbound 

Start Control Failure 

Cluster Solicitor Inbound Router 

Cluster Solicitor Outbouni Router 

Redrive Outbound 

Redrive Inbound 

Start Control Redrive 

End Control Outbound 

Connection Complete 

Redrive PSOP 

DIAL Disconnect 

PSOP Router 

Purge 

Start Control 

Port Solicitor 

Reset and Control Redrive 

Initial Contact Retry 

Start Input 

PSOP End Control 

Purge Outbound 

PSIP Router 

Network Solicitor 

Close ACB Phase I 

Close ACB Phase II 

Close ACB Phase III 

Closed DEB Interface Routine 

Change 

Close Destination Part I 

Close Destination Part II 

Close Destination Part III 

SRT Delete/Find 

Control Block Building 

Function Distribution 

Function Obtain 

Control Block Removal 

Logon Data Handler 

Master DVT Builder 

OPNDST - NIB Copy/Merge 

OPEN ACB Phase I 

OPEN ACB Phase II 

OPEN ACB Phase III 

OPENDST and SIMLOGON Phase I 

OPNDST Phase 2 

OPNDST and SIMLOGON Final Phase 

SETLOGON 

Real DVT Builder 

Function Release 

Routing 

SRT Add 

Skeleton DVT Reader 

Function Select 

Routing End 

Build Pool Routine 
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Module 
Name 



Descriptions 



IST0RC3S 

istorcrq 
istorcrt 
istpatch 
istpicba 
istpicca 
istpicce 
istpiccf 
istpicci 
istpicco 
istpiccs 
isrpiccr 

ISTPICCU 
ISTPICDD 
ISTPICDR 
ISTPICEI 
ISTPICES 
ISTPICFI 
ISTPICGI 
ISTPIC3P 
ISTPIC3R 
ISTPICIN 

isrpicir 
istpicla 
istpiclc 
istpicli 
istpicma 
istpicnr 
istpicqp 
istpicri 
istpicrp 
istpicsc 
istpicso 
istpicss 
istpicst 
istpicsu 
isrpicrF 
istpicth 
istpicto 
istpictr 
istpicxa 
istpicxf 
istpicxi 
istpicxl 
istpicxp 
istpicxo 
istpicxi 

ISTPICX2 
ISTPICX8 
ISTPIEBI 
ISTPIEBO 

ISTPIECP 
ISTPIEIF 
ISTPIEIR 
ISTPIEIS 
ISTPIELF 
ISTPIELO 
ISTPIELS 
ISTPIEPA 
ISTPIEPB 
ISTPIEBC 
ISTPIERF 
ISTPIERO 
ISTPIESA 



Request/Release Storage 

Request Buffers 

Return Storage 

VTAM Patch Area 

Dial-in Analyzer 

ATTN/READ Handler (Local 3270) 

Local 3270 Analyzer 

Control Command Analyzer 

Channel End Appendage CLocal 3270) 

Control Command Interpreter 

Command Scheduler 

Remote Command Updater 

Remote 3270 Command Updater 

Disconnect Handler 

BrU Analyzer 

ERP/VARY Interface 

Error Statistics Collection (Local Devices) 

Feedback Initiation 

General Interpreter 

General Poll Analyzer 

General Response Interpreter 

BTU Builder 

Remote 3270 Command Interpreter 

Local 3270 TEST Command Analyzer 

Local 3270 TEST Command Analyzer 

Local Control Command Interpreter 

Dial-in Analyzer (Start-Stop) 

Unsolicited BTU Handler 

2ueue Purger 

FSB Build 

READ Channel Program Build 

Remote 3270 

Switched Outbound Scheduler 

Session Scneduler 

I/O Session Completion Processing 

Session Update 

Trace Handler (Feedback) 

TOLTEP IRM Handler 

Trace Handler (Outbound) 

LCCW to CCW Translator (Local 3270) 

Extension to ISTPIEGR 

Extension to ISTPIEGP 

CZ Channel Program Initialization 

Local 3270 Channel Program Initiation 

Channel Program Initiation 

Extension to ISTIEGl 

Extension to ISTIET 

Extension to ISTPIECS 

Extension to ISTPIEDR 

Buffer Trace Inbound Bouter 

Buffer Trace Outbound Bouter 

Unsolicited Input 

DOS/VS Transmission services Inbound Interface 

First Outbound FID1 

SETL Outbound FIDl 

Local 3270 SR Feedback Processor 

Local 3270 SEND/RECEIVE Channel Program 

Local 3270 SR Session Control Interpreter 

First Inbound FIDl 

PIU Builder FIDl 

Record Mode Bequest Checker 

3270 Record Mode Response Analysis 

3270 Record Mode RU Builder 

SCTL Inbound FIDl 
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Module 
Name 

ISTPIESG 
ISTPIESI 

isrpiErr 

ISTRA^CA 
ISTRACCR 
ISTRA2TB 
ISTRACTE 
ISTRACTM 
ISTRACTO 
ISTRACTS 
ISTRACTtf 
ISTRAELS 
ISTECCYO 
ISTRCC21 
ISTRCC22 
ISTRCC23 
ISTRC:^26 
ISTRCC30 
ISTRCC51 
ISTRCC52 
ISTRC253 
ISTRCC54 
ISTRCS63 
ISTRCC65 
ISTRCC80 
ISTRCC81 
ISTSC02A 
ISTSC02B 
ISTSC02C 
ISTSC02D 
ISTSC02E 
ISTSC02F 
ISTSC020 
ISTSC:021 
ISTSC022 
ISTSC023 
ISTSC024 
ISTSC025 
ISTSC026 
ISTSC027 
ISTSC028 
ISTSC029 
ISTSC030 
ISTSC031 
ISTSC032 
ISTSC033 
ISTSC034 

istsdcal 
istsdcjap 
istsdcbu 
istsdcca 
istsdccb 
istsdccd 
istsdccf 
istsdccl 
istsdccn 
istsdccr 
istsdcci 
istsdcc2 

ISTSDCC3 
ISTSDCC4 
ISTSDCC5 
ISTSDCC7 
ISTSDCDS 



-+• 



Descriptions 

Inbound Segment Processor 

3270 Record System Control Interface 

TRACE Interface 

Add Service Routine 

Remove service Routine 

Buffer Trace Routine 

Trace Edit Control 

Main Trace Routine 

I/O 3uffer Edit 

Trace Edit Scan 

Trace Writer 

Trace Log Module 

Control Layer EPL Direct Post Routine 

Receive Macro Request Processor 

SEND Macro Request Processor 

RESETSR Macro Request Processor 

Send Response 

Record Feedback Start 

RECEIVE 1 Feedback 

RECEIVE 2 Feedback 

SEND Feedback 

Asynchronous Feedback 

House Any Queues 

SET RPL 

Clear Outbound Processor 

Clear Inbound 

TOLTEP GRAB 

TOLTEP LETGO 

TOLTEP MORECORE 

TOLTEP PLINK 

TOLTEP ROUTINE 

TOLTEP WAIT10 

TOLTEP-CECOM 

TOLTEP CONVERT 

TOLTEP $CUTE3T 

TOLTEP $DDATE 

TOLTEP DPRIN1 1 

TOLTEP SEND 

TOLTEP $DTIME 

TOLTEP EX10 

TOLTEP FREECORE 

TOLTEP GETCONFG 

TOLTEP acquisition 

TOLTEP Release 

TOLTEP DIO 

TOLTEP Receive 

TOLTEP MS Inbound Process 

ALERT Macro Handler 

Application RDT 

BUILD Macro Handler 

CIDADD Macro Handler 

Control Block Definition 

CIDDEL Macro Handler 

CIDFND Macro Handler 

CLUSTER Macro Handler 

FIND NCB Macro Handler 

CID, FINISH Macro 

System Definition Area Handler 

Error Message Formatter 

Macro Type Interpreter 

EBCDIC/Hex Conversion 

ADDBITS Routine 

tfork Area Handler 

DIALSET Macro Handler 



340 DOS/VS System Generation 



i Module 



Name 



i Descriptions 



ISTSDCD1 
ISISDCD2 
IST5DCD3 
ISTSDC3E 
ISTSDC3P 
ISTSDCHS 
ISTSDCIrJ 
ISTSDCLM 
ISTSDCLN 
ISTSDCLP 
ISTSDCLU 
ISTSDCML 
ISISDCMT 
ISTSDCOD 
IST5DCPA 

istsdcpc 

ISTSDCPU 

istsd::pi 

ISTSDCP2 

istsdcp3 
istsdcpu 

ISTSDCP5 
ISTSDCP6 

istsdcrc 
istsdcrn 
i sis dc rs 
istsdcsb 
istsdcsc 
istsdctm 
istsdcvb 
istsdcvg 
istsdcvi 

ISTSEC01 
ISTSEC10 
ISTSEC21 
ISTSEC30 
ISTSEZUO 
ISTSEC51 
ISTSQCOA 
ISTSQCOB 
ISTSQCOO 
ISISQCOl 
ISTS2C02 
ISTSQC03 
ISTS3C04 
ISTSQC05 
ISTSQC06 
ISTS2C07 
ISTSQC08 
ISIS2C09 

isrsfcoo 

isrrco35 

ISTTC037 

istvtson 
istvtcvt 
istvtldd 
istyclos 
istycont 
isiypsof, 
istysssp 



SRT Delete 

SNI Delete 

Interpret lable Load 

GENEWD Macro Handler 

Group Macro Handler 

Host Macro Handler 

INNODE Macro Handler 

Task Switching Routine 

LINE Macro Handler 

LUPOOL Macro Handler 

LU Macro Handler 

MTALIST Macro Handler 

MTALIST Macro Handler 

Device Type Table 

Path Macro Handler 

PCCU Macro Handler 

PO Macro Handler 

MTALIST Parameter Handler 

LIST Parameter Handler 

VIDSE2 Parameter Handler 

TERM Parameter Handler 

DIALSET Parameter Handler 

VPACIN3 Parameter 

System Definition Mainline 

SS RDT Build 

Shift/Default Entry Builder 

STARTBH Macro Handler 

SYSCNTRL Macro Handler 

Terminal Macro Handler 

VSBUILI) Macro Handler 

Switched/Local Skeleton Build 

VIDLIST Macro Handler 

Session Control Outbound Start 

Session Control Outbound Processing 

Session Control Feedback Processing 

Session Control Inbound Request Processing 

Session Control Auto Response 

Session Control 2ueue Purge 

Inquire TOP Logon Processor 

Inquire SESPA1M Processor 

Inquire Parameter Validation 

Logon Data Routine 

Device Characteristics Routine 

Active Count Routine 

Terminal Routine 

Application Status Routine 

Display Station Routine 

Communications Controller Name Routine 

CID Translation Routine 

Terminal Identification Routine 

Interpret Processor 

IOLTEP - DTERM 

TOLTEP - DUMP 

Storage for Configuration List 

Storage for DVT 

Module Load List 

Skeleton DVT for VARY (non-3DLC Devices) 

Skeleton DVT for VARY (non-SDLC Devices) 

Skeleton DVT for Port Solicitor 

Skeleton DVT for SSCP 
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Transients 



Linjc-Edit Statements (VTAM proper), 



$$ABERV1 SDR Counter Update 

$$ABERV2 OBR Record Builder 

$$ABER\/3 3705 ERP First Transient Load 

$$ABERV4 Local 3270 ERP First Transient 

Load 
$$ABERV5 3791 Error Recovery Procedure 
$$ABERV6 Local 3270 ERP Second Load 
$$ABERV7 3791 Statistical Data Recorder 

Extension 
$$BCST01 Close ACB Transient 
$$BCST02 Close ACB Transient, Return 

Linkage Routine 
$$BOST01 Open ACB Transient 
$$BOST02 Open ACB Transient, Return 

Linkage Routine 
$$BSTCNL EOJ Transient 
$$BSTCNl EOJ Transient, Return Linkage 

Routine 
$$RA.STli+ 3705 Channel Check ERP 
$$RAST15 Local 3270 Channel Check ERP 



// OPTION CATAL 

INCLUDE ISTLINKl 
// EXEC LNKEDT 

INCLUDE ISTLINK2 
// EXEC LNKEDT 

INCLUDE ISTLINK3 
// EXEC LNKEDT 

INCLUDE ISTLINK4 
// EXEC LNKEDT 

INCLUDE ISTLINK5 
// EXEC LNKEDT 

INCLUDE ISTLINK6 
// EXEC LNKEDT 

INCLUDE ISTLINK8 
// EXEC LNKEDT 



Ensure that no 
private core image 
liorary is assigned 



Link-E3it Statements (Network Control 
Program), 

// OPTION CATAL 

INCLUDE ISTLINK7 
// EXEC LNKEDT 



LINKING VTAM 



S2!i££§^^tem^^L^rajcjt_Rej[uir^ments 



VTAM link-edit books ISTLINK1 and 1STLINK8 
require operator response to // PAUSE 
statements when procedure LINKVTM is 
executed. ISTLINKl may require a // LBLTVP 
NSD(xx) statement wnen it is included at 
link-edit time (this statement reserves 
label processing area space at tne 
beginning of tne VTAM partition for the 
direct-access-formatted Network Control 
Program dump files) . 

If your VTAM network does not include a 
3705 (Network Control Program), an EOB 
operator response is all that is required. 
If, however, 3705 (Network Control Program) 
support is required, tne // LBLTYP 
statement must be entered at the console, 
in wnich case "xx" is to be replaced by a 
numeric value indicating the maximum numoer 
of disk file extents for a given Network 
Control Program dump file. 

If 3705 support is included later in 
your VTAM network, ISTLINK1 must be 
relink-edited to reflect this change. 
ISTLINK8 must be cataloged into the system 
core image library; hence, the operator 
must ensure that SYSCLB is unassigned when 
ISTLINK8 is included. This link-edit book 
includes VTAM modules and transients wnich 
may be fetched for a user partition 
whenever VTAM is operative in the system. 



Macros 



Blocks 



52 



5,492 



Macro_Names 

E . CHANGE 

E.CLSDST 

E.DO 

E.ENDINTAB 

E.EXECRPL 

E.IFGACB 

E.IFGEXLST 

E.IFGRPL 

E.IHBRDWRA 

E. INQUIRE 

E . INTAB 

E . INTRPRET 

E.ISTACB 

E.ISTACBG 

E.ISTAVT 

E.ISTBLDO 

E . ISTCBMTB 

E.ISTCB1 

E.ISTCB2 

E.ISTDBIND 

E.ISTDNIB 

E.ISTDPOHD 

E.ISTDPROC 

E.ISTDVCHR 

E . ISTEXLG 

E.ISTEXLST 



E.ISTRDWRA 

E.ISTRPL 

E.ISTRPLG 

E.ISTUSFBC 

E.LDO 

E.LOGCHAR 

E.MODEEND 

E.MODEENT 

E.MODETAB 

E.NETSOL 

E.NIB 

E.OPNDST 

| E.RCVCMD 
E. RECEIVE 
E. RESET 
E-RESETSR 

| E.SENDCHD 
E.SESSIONC 
E.SETLOGON 
E.SIML030N 
E. SOLICIT 
E.USSCMD 
E.USSEND 
E.USSMSG 
E.USSPARM 
E.USSTAB 
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APPLICATION PROGRAM STORAGE CONSIDERATIONS 

RPL Oriented Macro Instruction Storage 

VTAM RPL oriented macro instructions call an inner macro instruction IriBRDtfRA to expand 
code to modify RPLs. The parameters listed below snow the minimum and maximum 
expansions. All parameters, except the RPL parameter, are optional. 



r 




T T 


| Parameter 




| Minimum Expansion | Maximum Expansion 
I (bytes) j (bytes) 

J. X _ _ 


r 




T t 


| RPL 




| | 12 


j (If additional parameters are coded, include 




|8 bytes) 




1 8 1 8 


| ACB 




1 ** 1 b 


| AREA 




1 ^ 1 8 


| AREALEN 




1 4 | 16 


|RECLEN 




1 4 | 16 


1 AAREA 




j 4 | fa 


[ AAREALN 




1 4 | 16 


| ARECLEN 




j 4 | 16 


|ECB* 




| 16 | 20 


| EKIT* 




| 16 | 20 


| AR3+* 




1 8( & 


1 NIB** 




| 12 | 12 


| OPTCD 




j 14 | 48 


|S¥N or ASY 


subparameters 


1 ^ j 4 


JSEQNO 




I 4 | 14 


[BRANCH 




1 ** 1 ^ 


jlBSQVAL 




| 4 | 14 


| OBSQVAL 




| 4 | 14 


| RESPOND 




| 4 | 12 


| CHAIN 




1 8 | 8 


[CONTROL 




| 10 j 10 


| CHNGDIR 




1 ^ 1 8 


| BRACKET 




1 4 1 8 


|SSENSEO 




1 ^ 1 ** 


|USENSEO 




1 4 | 14 


| SSENSMO 




1 4 | 4 


|RTYPE 




1 4 | 16 


|STYPE 




1 ** 1 4 


| TBSQAC 




i 4 | 4 


j OBSQAC 




1 4 | 4 


|POST 




1 4( 4 


| Macro exit 


code 


| 14 j 14 


j Space lost 


due to CNOP alignment 


I | 2 



j. J. X ., 

I* Mutually exclusive ** Mutually exclusive | 

L J 



Since all parameters except the RPL parameter are optional, the minimum expansion for any 
RPL oriented macro instruction is 14 bytes. The maximum size of any RPL oriented macro 
instruction is 354 bytes. However, most macro instructions can be expected to use a 
subset of these parameters. Thus, as an aid to estimating tne size of these macro 
instructions in the user's partition, the following representative maximum expansion 
sizes are provided: 



Module 22: V1AM -- 5745-SC-VTM 343 



I Macro Instruction 

h 

CHAN3E 

CLSDST 

DO 

INQUIRE 

INTRPRET 

OPNDST 

RECEIVE 

RESET 

RESET5R 

SESSIONC 

SETL030N 

SIML03DN 

SOLICIT 



| Representative Maximum Expansion Sizes (oytes) 




^°D:trol._Bloclc__St.orac|;e 

The following are the sizes of VTAM control blocks that are ouilt in tne user's 
partition: 



:2Q:trol_Block_Name 

ACB 
NIB 
RPL 
EXLST 



Size (bytes) 

52 
64 
100 



15 to 80 (depending on which exits are specified) 



Manipulative Macro Instruction Storage 

VTAM manipulative macro instructions may be used to generate VTAM control blocks or to 
modify various fields in these control blocks. When the manipulative macro instructions 
are used, the user's application program partition must allow a 4K (4096 oyte) area to 
load the processing module, while allowing sufficient storage for the expansion of tne 
manipulative macro instructions. The following list snows tne minimum expansion sizes 
and a representative average expansion size of the manipulative macro instructions for 
each type of VTAM control block. 



Macro 


| Type of 


| Minimum 


Expansionl Re 


presentative 


Average Expansion Size 


Instruction] C 


ontrol Bloc 


k| 


(bytes) 






(oytes) 




I 




i_ 






i 






SENCB 


I 

I 
1 

1 
| 
1 


ACB 
EXLST 
NIB 
RPL 


T 

! 

1 
1 
1 

J 




54 
54 
54 
54 


t 




94 
118 

78 
100 


MODCB 


1 
1 
1 
1 

! 
i 


ACB 
EXLST 
NIB 
RPL 


T 

1 

1 

1 

1 
4_ 




60 
66 
66 
60 


T 
J. 




102 
98 
90 

100 


SHOtfCB 


i 
I 
1 

1 

1 
i 


ACB 
EXLST 
NIB 
RPL 


T 
1 
1 
1 
1 




66 

66 
66 
66 


t 

l 




104 

126 

96 

166 


TESTCB 


i 
i 

i 
1 
i 


ACB 
EXLST 
NIB 
RPL 


T 

1 
1 
1 
1 




66 
70 
70 
66 


t 




66 
70 
92 
70 



L i. X J. J 
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I Module 23: Subsystem Support Services - 5747-CC6 




Module 23: Subsystem Support Services -- 5747-CC6 345 



SUBSYSrEM_SUPPORT_SERVICES 

IBM Subsystem Support Services (SSS) Bust be included in the relocatable library. The 
generation of active load nodules for SSS does not take place vith the DOS/VS system 
generation process. Instead, SSS is generated in a separate process, concurrent with the 
generation of any of the following industry systems: 

IBM 3600 Finance Communication System 

IBM 3650 Retail Store System 

IBM 3660 Supermarket System 

IBM 3790 Communication System 

This generation process and the virtual storage estimates for SSS in DOS/vs are 
documented in the Ififl Syg-tem/379 Subsystem fia££2£i Se.cyic.es Dger^s Guide, GC30-3022. 
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Module 24: System Utilities - 5745-SC-UTL 

- 5745-SC-UTS 

- 5745-SC-APC 



Module Outline 




general 351 

partition size . ... 351 

analysis program-1 * 351 

core image library....... 351 

phase 351 

relocatable library 351 

modules 351 

link-edit statements 351 

delete statements 351 

assign alternate track disk. . . 351 

core image library 351 

phases 351 

relocatable library 351 

modules 351 

link-edit statements... 352 

delete statements 352 

assign alternate track data cell 352 

core image library 352 

phases 352 

relocatable library 352 

modules. . . 352 

link-edit statements 352 

delete statements 352 

clear disk. 352 

core image library 352 

phases 352 

relocatable library 352 

modules 352 

link-edit statements 352 

delete statements 352 

clear data cell 352 

core image library 352 

phases 352 

relocatable library 35^ 

modules 352 

link-edit statements 352 

delete statements 352 

copy disk to card 352 

core image library 352 

phases. 352 

relocatable library 353 

modules 353 

link-edit statements... 35 3 

delete statements 353 

copy disk to disk 353 

core image library 353 

phases 353 

relocatable library 353 

modules. *. 35 3 

link-edit statements 35 3 

delete statements 353 

copy disk or data cell to tape 353 

core image library... 353 

phases 353 

relocatable library. 353 



modules 353 

link-edit statements *... 353 

delete statements 353 

copy and restore diskette 353 

core image library 3 53 

phase 353 

relocatable library 353 

module 353 

link-edit statements 353 

delete statements 353 

deblock utility 353 

core image library 353 

phase 353 

relocatable library 353 

modules 353 

link-edit statements 354 

delete statements 354 

fast copy disk volume 354 

core image library 

phases (integrated version) 3 54 

phase (standalone diskette 

version) 354 

relocatable library 

modules (integrated version) 354 

module (standalone diskette 

version) 354 

link-edit statements 

(integrated version) 354 

(standalone diskette version) 354 

source statement library 

(standalone versions) 354 

macro 354 

statements to obtain 

standalone card deck version 354 

statements to obtain 

standalone diskette version 354 

delete statements 354 

initialize disk . 354 

core image library 354 

phases 354 

relocatable library 354 

modules 354 

link-edit statements 354 

delete statements 354 

initialize data cell 355 

core image library 355 

phases 355 

relocatable library 355 

modules 355 

link-edit statements 355 

delete statements 355 

initialize tape , 355 

core image library 355 

phase 355 
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relocatable library 355 

modules 355 

link-edit statements 355 

delete statements 355 

copy file and maintain object 
module 355 

core image library 355 

phase. 355 

relocatable library 355 

module 355 

link-edit statements 355 

delete statements. 355 

restore program 355 

core image library 355 

phase , 355 

relocatable library 355 

module 355 

link-edit statements 355 

delete statements 355 

backup program 355 

core image library 355 

phase 355 

relocatable library 356 

module 35o 

link-edit statements 356 

delete statements 356 

source statement library 356 

maintain system nistory 356 

core image library. 356 

pnases 356 

relocatable library 356 

modules 356 

link-edit statements 356 

delete statements 356 

source statement library 356 

macros 356 

HIST macro description 356 

generation example 357 



list system history 357 

core image library 357 

relocatable library module 357 

link-edit statements 357 

delete statements 357 

restore card to disk 357 

core image library 357 

phase 357 

relocatable library 357 

modules 357 

link-edit statements 357 

delete statements 357 

restore tape to disk or data cell 357 

core image library 357 

phase 357 

relocatable library 357 

modules 357 

link-edit statements 358 

delete statements 358 

VTOC display 358 

core image library 358 

phase 358 

transient 358 

relocatable library 358 

modules (BJS) 358 

link-edit statements, 

non-multiprogramming system 358 

delete statements, 

non-multiprogramming system 358 

modules (MPS) 358 

link-edit statements, 

multiprogramming system 358 

delete statements, 
multiprogramming system 358 
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Module Index 

A 

analysis program-1 

delete statements... 351 

link-edit statements 351 

module names 351 

phase names 351 

assign alternate track data cell 

delete statements 352 

link-edit statements 352 

module names 351 

phase names 351 

assign alternate track disk 

delete statements 352 

link-edit statements 352 

module names 351 

phase names 351 



backup 

delete statements 356 

link-edit statements 356 

module names 356 

phase names 381 



clear data cell 

delete statements 352 

link-edit statements 352 

module names 352 

phase names 352 

clear disk 

delete statements 352 

link-edit statements 352 

module names 352 

phase names 352 

copy disk to disk 

delete statements 353 

link-edit statements 353 

module names 353 

phase names 352 

copy and restore diskette 

delete statements 353 

link-edit statements 353 

module names 353 

phase names ., 353 

copy disk or data cell to tape 

delete statements 353 

link-edit statements 353 

module names.. 353 

phase names 353 

copy disk tc card 

delete statements 353 

link-edit statements 353 

module names 353 

phase names 352 

copy file and maintain object 
module (OBJMAINT) 

delete statements ,». 355 

link-edit statements 355 

module names., 355 

phase names 355 



deblock 

delete statements 354 

link-edit statements 354 

module names 353 

phase names 353 



fast copy disk volume 

delete statements 354 

link-edit statements 354 

macro 354 

module names , 354 

obtain executable version 354 

phase names 354 

H 

HIST macro 356 

HISTLIST (list system history) 357 

I 

initialize data cell 

delete statements 355 

link-edit statements 355 

module names 355 

phase names 355 

initialize disk 

delete statements 354 

link-edit statements 354 

module names 354 

phase names 354 

initialize tape 

delete statements 355 

link-edit statements 355 

module names 355 

phase names 355 

L 

library requirements 351 

list system history 357 



M 



maintain system history (PTFHIST) 

delete statement. 356 

generation example 356 

HIST macro 356 

link-edit statements 356 

macros..... 356 

module names. 356 

phase names 356 



OBJMAINT (copy file and maintain 
object module) 



355 
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P module names 357 

phase names 357 

PTPHIST (maintain system history) 356 

prelinked utilities 351 

T 

r transients, IBM-supplied 

$$BLVTOC 358 

restore 

delete statements 355 

link-edit statements 381 v 

module names 355 

phase names 355 VTOC display 

restore card to disk delete statements..... 353 

delete statements 383 link-edit statements 358 

link-edit statements... 383 module names 358 

module names 383 phase names 358 

phase names 383 

restore tape to disk or data cell 

delete statements 357 

link-edit statements 358 
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Genera l 

System utilities are supplied prelinked in the core image library except the following: 

Maintain system History 
Assign Alternate Track Data Cell 
Clear Data Cell 
Initialize Data Cell and 
Print the Hard-Copy File 

For details on number of phases (modules, books) and number of blocks per library , refer 
to "Library Beguirements" in Module 1 of this manual. 

Instead of the link-edit and delete statements given in this module of the manual, the 
IBM-supplied cataloged procedures may be used; refer to "Link-Edit and Delete Procedures" 
in Module 1. 



PARTITION SIZE 

Between 6K and 64K of real storage 
depending on utility. Refer to DOS/V S 
System Utilities for details. 



Delete_Statements 

DELETR IAQMAP 
DELETR IAQMAPl 
DELETR IAQMAP2 
DELETR IAQMAP3 



Analysis Program- 1 



Assign Alternate Track Disk 



^2RE_I^55_LIBRARy 

Phase 

API 

RELOCATABLE LIBRARY 

Modules 

IAQMAP 
IAQMAPl 
IAQMAP2 
IAQMAP3 

Link- Edit ^Statements 

INCLUDE IAQMAP 
// EXEC LNKEDT 



CORE IMAGE LIBRARY 

Phases 

ALTDK 

ALTDK2 

ALTDK3 

ALTDK4 

ALTDK5 

RELOCATABLE LIBRARY 

Module s 

IJWATD 

IJWATD1 

IJWATD2 

IJWATD3 

IJWATDU 

IJWATD5 
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Link-Edit Statements 

INCLUDE IJWATD 
// EXEC LNKEDT 

Delete Statements 



DELETR 
DELETR 
DELETR 
DELETR 
DELETR 
DELETR 



IJrfATD 

IJWATDl 

IJMATD2 

IJWATD3 

IJWATD4 

IJtfATD5 



Assign Alternate Track Data Cell 

CORE IMAGE LIBRARY 

Phases 

ALTDC 

ALTDC2 

ALTDC3 

ALTDC4 

ALTDC5 

RELOCArABLE_LIBRARY 

Modules 

IJWATM 

IJWATM1 

IJWATM2 

UtfATM3 

IJtfATMU 

IJWATM5 

Link- Edit Statements 

INCLUDE IJWATM 
// EXEC LNKEDT 

Delete Statements 



DELETR 
DELETR 
DELETR 
DELETR 
DELETR 
DELETR 



IJWATM 

IJtfATMl 

IJWATM2 

IJWATM3 

IJWATM4 

IJWATM5 



Clear Disk 

CORE IMAGE LIBRARY 

Phases 

CLRDK 

CLRDK2 

CLRDK3 



RELOCATABLE LIBRARY 

Mod ules 

IJtfCCD 
IJrtCCDl 
IJWCCD2 
IJWCCD3 

Lin k-Edit Statements 

INCLUDE IJWCCD 
// EXEC LNKEDT 

D e 1 e t e_ Statements 

DELETR IJWCCD 

DELETR IJWCCDl 

DELETR IJWCCD2 

DELETR IJWCCD3 



Clear Data CeU 

CORE IMAGE LIB RARY 

Phase s 

CLRDC 

CLRDC2 

CLRDC3 

RELOCATABLE^LIBRARY 

Modules 

IJWCCM 
IJWCCM1 
IJWCCM2 
IJWCCM3 

Link-Edit Statements 



INCLUDE IJWCCM 
// EXEC LNKEDT 



Delete ^Statements 

DELETR IJWCCM 
DELETR IJWCCMl 
DELETR IJWCCM2 
DELETR IJWCCM3 



Copy Disk to Card 

CORE IMAGE LIBRAR Y 

Phases 

CDKCD 
CDKCD2 
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RELOCATABLE LIBRARY 



Modules 



IJtfCDC 

IJWCDCl 

IJtfCDC2 



Link-Edit .Statements 

INCLUDE IJtfCDC 
// LBLTYP NSD(nn) 
// EXEC LNKEDT 

Delete_Statements 

DELETR IJWCDC 
DELETR IJtfCDCl 
DELETR IJWCDC2 



Copy Disk to Disk 

^QRE_IMAGE_LIBRARY 

Phases 

CDKDK 
CDKDK2 

RELOCArABLE_LIBRARX 
Modules 

IJtfCDD 

IJWCDD1 

IJWCDD2 

Link- Edit Statements 

INCLUDE IJtfCDD 
// LBLTYP NSD(nn) 
// EXEC LNKEDr 

Delete Statements 

DELETR IJWCDD 
DELETR IJWCDD1 
DELETR IJWCDD2 

Copy Disk or Data Cell to Tape 



MJ^OC AT AB LE_LI B R AR Y 

Modules 

IJtfCDT 

IJW2DT1 

IJrfCDT2 

Link-Edit Statements 

INCLUDE IJtfCDT 
// LBLTYP NSD(nn) 
// EXEC LNKEDT 

Delete Statements 

DELETR IJWCDT 
DELETR IJWCDT1 
DELETR UtfCDT2 



Copy and Restore Diskette 

£2EE_IMAGE_LIBKARY 

Phase 

CRDR 

REL OC AT AB LE _LI B R AR Y 

Module 

IJtfCRD 

Link-Edit Statements 

PHASE CRDR,S 
INCLUDE IJWCRD 
// EXEC LNKEDT 

Dglgte Statements 

DELETR IJWCRD 

Deblock Utility 

CORE IMAGE LIBRARY 

Phase 

DSTRB 



^ORE_i.^SE_LIBRARY 

Phases 

CDKTP 
CDKTP2 



RELOCATABLE LIB RARY 

Modules 

IJWDST 
IJWDST1 
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Link-Edit, Statements 

INCLUDE IJWDST 
// LBLTYP TAPE 
// EXEC LNKEDT 

Delete ^Statements 

DELETR IJWDST 
DELETR IJWDST1 



Fast Copy Disk Volume 

QQEE_I?!^SE_LIBRAR3f 

Phases (Integrated Version) 

FCOPY 
FCOPY2 

pnase (Standalone piskette_Version) 

DKTPIPL 

RELOCATABLE LIBRARY 

Modules _ (Integrated Version ), 

IJWDFC 
IJWDFC1 

IJ/7DFC2 

Module (standalone D iskette^yersion) 

IJWDFCD 

Link-Edit ^Statements (I nt egrat ed Vers ion ) 

// OPTION CATAL 

INCLUDE IJWDFC 
// LBLTYP TAPE 
// EXEC LNKEDT 

Link-Edit^Statements , (S t andalonePisk et te 
Version), 

// OPPION CATAL 

INCLUDE IJWDFCD 
// LBLTYP TAPE 
// EXEC LNKEDT 



Statements_to_Qbtain Standalone_Card Deck 
Version 

// EXEC SSERV 

PUNCH Z.FASTCOPY 
/* 

s t atejients_t o _Qbtain_Standalone Dis kett e 
Version 

// DLBL IJSYSPri 

// EXTENT 

// ASSGN SYS006,X'cuu' 

// EXEC DKTTIPL 

ASSGN SYSPCHjX'cuu' same diskette unit 

// EXEC SSERV 

PUNCH Z.FASTCOPD 

/* 

CLOSE SYSPCH,UA 

/& 

Qelete_Statements 

DELETC DKTTIPL 
DELETR IJWDFCD 
DELETR IJWDFC 
DELETR IJWDFC1 
DELETR IJWDFC2 
DELETS Z.FASTCOPY 
DELETS Z.FASTCOPD 



Initialize Disk 

CORE IMAGE LIBRARY 
Phases 



INTDK 
INTDK2 
INTDK3 
INTDK4 



RELOCATABLE LIBRARY 

Modules 

IJWIND 

IJWIND1 

IJWIND2 

IJHIND3 

IJWIND4 

Link -Edit ^S tat ements 

INCLUDE IJWIND 
// EXEC LNKEDT 



SOURCE STATEMENT LIBRARY (STANDALONE 
VERSIONS), 

Macro 

Z.FASTCOPY (Card Version) 
Z.FASTCOPD (Diskette Version) 



D e lete statements 

DELETR IJWIND 
DELETR IJWIND1 
DELETR IJWIND2 
DELETR IJWIND3 
DELETR IJWIND4 
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Initialize Data Cell 



Copy File and Maintain Object Module 



!ORE IMAGE LIBRARY 



Phases 

INTDC 
INTDC2 
INTDC3 
INTDC4 



RELOCATABLE LIBRARY 

Modules 

IJWINM 

IJWINM1 

IJWINM2 

IJWIMM3 

UtfINM4 

Link- Edit Statements 

INCLUDE IJWINM 
// EXEC LNKEDT 

Delete Statements 

DELETR IJWINM 
DELETR IJWINM1 
DELETR IJWINM2 
DELETR IJWINM3 
DELETR IJWINMU 



CORE IMAGE LIBRARY 

Phase 

OBJMAINT 

RELOCATABLE LIBRARY 

Module 

IJWOBJM 

Link-Edit S tat ements 

INCLUDE IJWOBJM 
// EXEC LNKEDT 

Delete Statements 
DELETE IJWOBJM 

Restore Program 

CORE IMAGE LIBRARY 
Phase 

RESTORE 



Initialize Tape 

£9EE_I«AGE_LIBRARY 
Phase 

inttp 

relocarable library 

Modules 

IJWINT 
IJWINT1 

Link- Edit Statements 

INCLUDE IJWINT 
// EXEC LNKEDT 

Delete _Statem ents 

DELETR IJWINT 
DELETR IJWINT1 



RELOCATABLE LIBRARY 

Module 

IJWSARST 

Link-Edit Stat eme nt s 

INCLUDE. U.HSAEST 
// EXEC LNKEDT 

Delete^Statemen t s 

DELETE IJWSARST 

Backup Program 

CORE IMAGE LIBRARY 

Phase 

BACKUP 
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RELOC^r^BLE_LIBRARY; 

Module 

IJWSABK 

Link-Edit Statements 

INCLUDE IJtfSABK 
// EXEC LNKEDT 



HIST Macro Description 



HIST REL=' release' , CUST=*name' 



[ , ADDR= ' address ' ] [ , PHONE- ' numoer ' ] 

[ , PROG=' programmer 1 ] 

[ , ENV= ' environment ' ] 

[ , SCPHIST-SYSTEM | PRIVATE] 

[ , PPHIST=PRIVATE j SYSTEM] 



Delete sta tements 
DELETR UtfSABK 
SQURCE_SrATEMENT_LIBRA.RY 
Z.BPSFILES 

Maintain System History 

CORE IMAGE LIBRARY 



'release' Specifies the SCP release to 

which this nistory belongs. A. 
character string up to 8 bytes 
long, enclosed in apostrophes. 



'nane' The customer's name (ana number, 
if applicable) . A cnaracter 
string of up to 40 bytes, 
enclosed in apostropties. 



'address* The customer's address. A 

character string of up to 40 
bytes, enclosed in apostropnes. 



Phases 

ptfhist 
ptfrepro 



RELOCAI^BLE_LIBRARy 



Modules 

IKRSMP1 
IKRSMP2 
IKRSMP3 (generated by HIST macro) 



Link-Edit ^Statements 

Link-edit will be generated by HIST macro 
assembly. 



Dglgte Statements 

DELETR IKRSMPl 
DELETR IKRSMP2 
DELETR IKRSMP3 

SQURCE_STfiLTEMENT_LIBRARy 

Macros 

E.HIST 
Y.PTFSCP 
Y.PTFPP 4S2 



'number' The customer's telephone number. 
A. character string of up to 40 
bytes, enclosed in apostrophes. 



' programmer ' 

The name of tne system 
programmer. A. character string 
of up to 4 bytes, enclosed in 
apostrophes. 

' environment' 

Tne hardware/software 
environment. ft character string 
of up to 40 bytes, enclosed in 
apostropnes. 

CPHIST=S YSTEM I PRIVATE 

The source statement Horary in 
which the SCP history Y.PTFSCP 
is cataloged. If this operand 
is omitted, tne default is 
SYSTEM. 

PPHIST=PRIVATE | SYSTEM 

Tne source statement library in 
which tne PP nistory Y.PTFPP is 
cataloged. If this operand is 
omitted, the default is PRIVATE. 

The output resulting from the BIST macro 
consists of job control statements for 
three steps: 

1. A step to update the history headers 
with the customer information provided 
in the macro. 
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2. A step which catalogs an assembles 
module into the relocatable library. 
Tnis module then becomes part of tne 
D03/VS PTFHIST and contains information 
indicating wnere tne nistory oooks are 
cataloged. 

3. A final step tfhicn catalogs tne DDS/VS 
PTFHIST into the core image library. 



feneration Example 

// JOB PTFHIST INSTALLATION 
// OPTION DECK 
// EXEC ASSEMBLY 

HIST REL=" 33. 0' , 

CUST='EVA CORPORATION', 

ADDR=*2 MAIN STREET, ANYWHERE', 

PHONE=' 017-723-977' , 

PROS---' TOM SMITH* , 

PPHIST=S¥STEM 



END 



/* 

/& 



Previous entries in books Y.PTFSCP and 
Y.PTFPPj, except customer information, are 
retained. 



List System History 

Core Imatje Library 

P]iase 

HISLIST 

RELOCATABLE LIBRARY 

Module 

JKSHIST 



Restore Card to Disk 

^QM_IMAGE_LIBRARY 

Pnase 

RCDDK 

RELOCArABLE_LIBRARy 

Modules 

IJWRCD 
IJWRCD1 

Link-E3it_Staternents 

INCLUDE IJWRCD 
// LBLT¥P NSD(nn) 
// EXEC LNKEDT 

Q§l§te_Statements 

DELETR IJWRCD 
DELETR IJWRCD1 

Restore Tape to Disk or Data Cell 

CORE_IMAGE_LIBRARY 

Phase 

RrPDK 

RELOCATABLE_LIBRARY 

Modules 

IJWRTD 
IJWRTD1 



LinK'Idit Statements 

INCLUDE IKRHIST 
// EXEC LNKEDT 



Link-Edit S tat e men ts 

INCLUDE IJWRTD 
// LBLTiTP KSD(IO) 
// EXEC LNKEDT 



JB£.l§iS Statements 
DELETE IKRHIST 



Delete Statements 

DELETR IJWRTD 
DELETR IJWRTD1 
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VTOC Display 

^O^E_IM^GE_ LIBRARY 

Phase 

LVTOC 

Transient 

$$BLVTOC 

Note: $$BLVTOC is cataloged into the core 
image Horary along with tne VTOC program. 



RELOCAT^BLE_LIBRARX 

Modules (BJS) 

IJWLTVB 
IJWLTVT 
IJWLTV1 

Link- Edit ..State ]ients^_Non-Multi prog ramming 
System 

INCLUDE IJWLTVB 
// LBLTiTP TAPE 
// EXEC LNKEDT 



Qgigte_5tatements^ No n-Mul tiprogramming 
System 

DELETR IJWLTVB 
DELETR IJWLTVM 



Modules _XMP S). 

IJWLTVM 
IJWLTVT 
IJWLTV1 



Link-Edit Statements, Multiprogramming 
System 

INCLUDE IJWLTVM 
// EXEC LNKEDT 



Qglgte_Statements^_Mu lti programming_Sy_stem 

DELETR IJWLTVM 
DELETR IJWLTVB 
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PARTI TI ON _SIZE 

The program requires a real partition 
allocation of 10K bytes. 

CORE I MAGE LI BRAR Y 

r t 1 

| Phases | Blocks | 
r x x ^ 

| Transients | 1 | 1 | 
h x + < 

I | Phases | 131 j 344 j 
' l x x J 



Transi ents 

$$BSDRCJP 

Phases 

EREP 

EREPADPT 
EREPASTA 
EREPCCH 
EREPCCHC 
EREPC125 
EREPC135 
EREPC145 
EREPDOLD 
EREPEDCP 
EREPEDCR 
EREPEDCO 
EBEPEDC1 
EBEPEDC2 
EEEPEDC3 
EREPEDDA 
EREPEDDK 
EBEPE001 
EHEPEDES 
EREPEDIT 
EREPEDRN 
EREPEDTO 
EREPEDTP 
EREPEDTR 
EREPEDT1 
EREPEDUR 
EREPEDU1 
I EREPEDU2 
EREPEDVr 
EREPEDX1 
EREPEOD 
EREPESPr 
EREPESTR 
EREPESWK 
EREPHISI 
EREPIPL 
EREPMCAR 
EREPMCRC 
EREPMICR 
EREPMNTR 
EREPM1U5 
EREPH158 
EREPROE 
EREPRETV 
EREPSSRT 



EREPSHRU 

EREPSMCP 

EREPSMCR 

EREPSMCU 

EBEPSHC1 

EBEPSHC3 

EREPSMDA 

EREPSMDK 

EREPSMD1 

EREPSMES 

EREPSMRN 

EREPSMTD 

EREPSMTP 

EREPSMTR 

EREPSMT1 

EREPSMUR 

EREPSMU1 

EREPSMVr 

EREPSPCL 

EREPTES 

EREPTPE1 

EREPUCCM 

EREPUNIT 

EREPUOLD 

EREPVRNO 

EREPVRN1 

EREPVRN2 

EREPVRN3 

EREPVRN4 

SREPVRN5 

EREPVTAM 

EREP145A 

EREP145B 

EREP145C 

EREP145D 

EBEP1581 

EBEP158B 

EBEP158C 

BBEP158D 

EBEP158E 

EBEP158F 

EBEP158G 

EBEP158H 

EBEP158J 

EBEP158K 

EBEP158L 

ERBP158H 

EBEP158M 

EBEP158P 

EBEP1580 

EREP2400 

EREP2715 

EBEP320X 

EBEP3203 

EREP3211 

EREP333M 

EREP333X 

EREP333Y 

EREP333Z 

EREP3330 

EREP3340 

EREP334W 

EREP334X 

EREP334JT 

EREP334Z 

EBEP335T 

EBEP335Z 

EBEP3350 
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EREP3U10 
EREP3420 
EREP3500 
ERSP3540 
EKEP3705 
EREP3800 
EREP3801 
EREP3802 
EREP3803 
EREP3804 
EREP3805 
EREP3806 
EREP3807 
EREP380X 
EREP389M 
EREP389N 
EREP389X 
EREP3895 



RELOCATABLE LIBRARY 



r t 1 

J Modules | Blocks | 

j. + ^ 

1 127 | 1,632 | 

t x J 

Modules 

IJBEADPT 

I J BEAST A 

IJBECALA 

IJBECALB 

IJBECALC 

IJBECALD 

IJBECCH 

IJBECCHC 

IJBEC125 

IJBEC135 

IJBEC1U5 

IJBEDOLD 

IJBE2DC? 

IJ3EEDCB 

IJBEBDC0 

IJBEEDC1 

IJBIEDC2 

IJBF.EDC3 

T.JBEEDDA 

IJBEEDDK 

IJBEEDD1 

IJBEEDES 

IJBBEDir 

IJBEEDRi* 

IJBEEOrD 

IJ3EE0TP 

IJBEEDTR 



IJBEEDT1 

IJBEEDUR 

IJBEEDU1 

IJBEEDU2 

IJBEEDVr 

IJBEEDX1 

IJBEEOD 

IJBEESPT 

UBEESTR 

IJBEESWK 

IJBEHISr 

IJBEIPL 

IJBEMCAR 

IJBEMCRC 

IJBEMICR 

IJBEMNTR 

IJBEM145 

IJBEH158 

IJBERDE 

IJBEBEP 

IJBERETV 

IJBESHRT 

IJBESHRU 

IJBESMCP 

IJ8ESMCR 

IJBESMCU 

IJBESHC1 

IJBESHC3 

IJBESMDA 

IJBESMDK 

IJBESMD1 

IJBESMES 

IJBESMRN 

IJBESMTD 

IJBESMTP 

IJBESMrR 

IJBESMri 

IJBESMUR 

IJBESMUl 

IJBESMVT 

IJBESPCL 

IJBETES 

IJBETPE1 

IJBEUCCM 

IJBEUNIT 

IJBEUOLD 

IJBEVRHO 

IJBEVRN1 

IJBEVRH2 

IJBEVRN3 

IJBEVRNl* 

IJBEVRN5 

IJBEVTAH 

IJBE145A 

IJBE14 5B 

IJBEl<l5C 

IJBE1U5D 
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IJBI158A 
IJBE158B 
IJBE158C 
IJBE158D 
IJBE158E 
IJBE158F 
IJBE1586 
IJBE158B 
IJBE158J 
IJBE158K 
IJBE158L 
IJBE158M 
IJBE158N 
IJBE158P 
IJBE1580 
IJBE2U00 
IJBE2715 
IJBE320X 
IJBE3203 
IJBE3211 
IJBE333Z 
IJBE3330 



IJBE334Z 
IJBE3340 
IJBE335Y 
IJBE335Z 
IJBE3350 
IJBE3U10 
IJBE3U20 
IJBE3500 
IJBE3540 
IJBE3705 
IJBE3800 
IJBE3801 
IJBE3802 
IJBE3803 
IJBE3804 
IJBE3805 
IJBE3806 
IJBE3807 
IJBE380X 
IJBE389M 
IJBE3895 
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LJQ!£~Edit_Statements 

INCLUDE IJBECALA. 
// EXEC LNKEDT 

INCLUDE IJBEC&LB 

Retrieval) 
// EXEC LNKEDI 

INCLUDE IJBECkLC 
// EXEC LNKEDI 

INCLUDE IJBECALD 

Statistics) 
// EXEC LNKEDT 

INCLUDE IJBERDE 
// EXEC LNKEDT 



(Monitor) 
(Edit/Select 

(Summary) 
(lape Error 

(RDE Summary**) 



* 80 byte area reserved for tape label 
processing. inis procedure does away 
with the necessity of including a 
// LBLPYP card. 

** The summary function will supply 
meaningful information only if 
ERRLOG=RDE is specified during system 
generation. 



Del eteState gnents 

DELETR IJBEREP, IJBE&DPT, IJBEASTA, etc. 
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3UFSIZE 1 

bypass initialize disk 1 



AB 1 

ABD 3 

abnormal termination exit (AB) 1 

ACANCEL 1 

access method services, DOS/VS 1, 17 

access method, virtual storage 1 

add unique library entries 1 

address specification during IPL 1 

ALIGN 1 

ALLOC 1, 22 

ALLOCE 1, 22 

allocate 1 

allocating library sizes 1 

alternate track assignment disk 24 

secondary storage requirements 1 
alternate track assignment data cell 



secondary storage requirements 1 
analysis program- 1 1,24 
AP 1 
AP-1 1,24 
APBUF 22 
ASCII 1 
ASL 3 
assemble installation verification 

procedure 1 
assembler 18 

secondary storage requirements 1 
assembler work file 1 
ASSGN macro 1 

attention interrupt during IPL 1 
attention routines, initiators, 

terminators 1 
automatic documentation of supervisor 

generation macros 1 



B 



backup 24 

back-up of libraries 1 

backup utility 1 

basic supervisor generation macros 

basic QTAM logic modules 21 

BGPGE 1 

BGR 1 

BLKMPX 1 

block multiplexing support 1 

blocks per cylinder, system library 

BHPX 1 

BPSFILES 24 

BSCLNS 1 

BTAM 20 

secondary storage requirements 
BTMOD (BTAM logic module) , size of 
buffer pools, VTAM 22 



CAP 3 

card to disk 24 

secondary storage requirements 1 
cardless systems, machine retirements 1 
catalog assembled supervisor 1 
CBF 1 
CCHAIN 1 

CDMOD (card module names for compilers) 1 
real storage requirements 7 
24 CHAN 1 

change supervisor contents 1 

CHANQ 1 

CHANSW 1 

CHAESET 1 

checkpoint/restart 1 

CHUN 1 

CIL patch program (PDZAP) 1 

clear data cell 24 

secondary storage requirements 1 
clear disk 24 

secondary storage requirements 1 
coding specification for // ASSGN 1 
command chaining (CCHAIN) 1 
common librarian modules 1 
compile a supervisor 1 
compiler IOCS modules 7 
component requirements 1 
component sizes 1 
computing the size of a supervisor 1 
CONFG macro 1 
configuration of IBM-supplied 

supervisors 1 
considerations for linking VTAM 22 
considerations for system generation 1 
console buffering 1 
copy and restore diskette 24 

secondary storage requirements 
copy disk or data cell to tape 24 
1 secondary storage requirements 

copy disk to card 24 

secondary storage requirements 
copy disk to disk 24 

secondary storage requirements 
copy file and maintain object 
1 module 24 

secondary storage requirements 
copy system disk to tape 1 
copying selectively to merge libraries 1 
core image library 

assembler 18 
20 components 1 

CORGZ 1 
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CSERV 1 

directory 1 

DOC 1 

DSERV 1 

DUMPGEN 1 

EREP 1, 25 

ESERV 1 

IBM 3211 printer support 

IBM-supplied 1 

IPL 1 

job control 1 

linkage editor 1 

MAINT 

MCAR/CCH 1 

CLTEP 19 

PDAIDS 1 

PDSDM 

EMS 1 

RSERV 

SSERV 

standard system dump 1 

supervisor macros 1 

supervisor nucleus 1 

T/P, BTAM 20 

T/P, QTAM 21 

transients (see transients) 

translating system dump 1 

utilities (system) 24 
CORGZ 1 
creating a back-up of your generated 

system volume 1 
creating a third library from existing 

libraries 1 
cross-partition event control 1 
CSEEV 1 
CYL 1 
cylinder capacity, system library 1 



D 



DAMOD (direct access module names for 

compilers) 7 

real storage requirements 8 
DASDFP 1 
DATE 1 
DEC 1 
DECK 1 
declaring SYSEES libraries as private 1 

libraries 1 
define labels 1 

define the page data set (DPD) 1 
deleting entries and merging libraries 
DELUNSD 3 
DEFUSED 3 

device address specification 1 
device I/O modules requirements (QTAM) 
device type code 1 
DFTRMLST (define the terminal list 

BTAM) 20 
diagnostics 18 
DIMOD (device independent module names for 

compilers) 7 

real storage requirements 1 



directory capacit 
DISK 1 
disk ERP 1 
disk to card 24 
secondary stor 
disk to disk 24 
secondary stor 
disk work files 
assembler 18 
modules 7 
display operator 
display source of 
distribution tape 
DOC 1 
DOS/VS component 

requirements 1 
DPD macro 1 
DEMOD (3886 modul 
DSERV 1 
DTFBT (define the 

table 20 
DTFBTND (define t 

of table 20 
DTFCD (define the 

table 1 
DTFCN (define the 
DTFDA (define the 

device) 8 
DTFDI (define the 

system units) 
DTFDE table requi 
DTFDU (define the 
DTFIS (define the 

sequential) 10 
DTFME (define the 

reader) 11 
DTFMT (define the 

size of table 
DTFOE (define the 

size of table 
DTFPH (define the 

size of table 
DTFPR (define the 

table 1 
DTFPT (define the 
DTFQT (define the 
DTFSD (define the 

DASD) 16 
DTFSB (define the 
dumps 1 
DUMOD (diskette u 
DUMODFI 9 
DUMODFO 9 
DUMP 1 
DUMPGEN 1 
1 DVCGEN macro 1 
DVCTYP 1 
D2311 
D2314 
21 D2321 
D2400 
D3330 
D3340 
D3350 
D3410 
D3420 



ies, system 1 

age requirements 1 
age requirements 1 



console (DOC) 1 
supervisor 1 
1 

sizes and library 



e) 14 

file BTAM) , size of 

he file end BTAM) , size 

file card) , size of 

file console) 1 
file direct access 

file device independent 
1 
rements 14 

file diskette file) 9 

file indexed 

file magnetic character 

file magnetic tape) , 
12 

file optical reader) , 
13 

file physical IOCS) , 
1 

file printer) , size of 

file paper tape) 15 
file QTAM) 21 
file sequential 

file serial device) 1 

nit module) 9 
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D3540 

I D3800 

D3886 
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G 



generated system volume 
GETVIS 1 

GETVIS area in SVA 1 
GRFlxxxx phases 1 



ECPREAL 1 

EDECK 1 

EMA 3 

EMA NAME 3 

EMATA 3 

EMATSN 3 

EMATYPE 3 

EMB 3 

EMBNAME 3 

EMBTA 3 

EMBTSN 3 

emulator generation 1 

linkage editor statements 6 

module names and sizes 6 

modules, number of 6 
emulators, verification procedures for 
end of supervisor macro instruction, 

SEND 1 
environmental recording, editing, and 

printing program 1 
EPTDVT 22 
EREP 1, 25 
ERRLOG 1 
error statistics by tape volume 1 

2495 Tape Cartridge Reader 1 
ERRQ 1 
ERRS 1 
ESERV 1, 18 
EU parameter 1 
EVA parameter 1 
example for system generation 1 
EXIT 1 
E20 3 
E20NAME 3 



failure in generating a system 

fast CCW translation 1 

FASTTR 1 

fast copy disk volume utility 

FETCH 1 

FIXPOOLS 22 

forced macros 1 

FOPT macro 1 

FP 1 

FnPGR 1 

Fn 1 

FnR 1 



1, 24 



H 



hard-copy file 1 
high-speed standalone dump 
HIST macro description 24 
HISTLIST 1, 24 



I 



I/O configuration, system generation 
example 1 

IBM-supplied libraries 1 

IBM DOS/VS distribution 1 

IBM 2314 work file requirements 1 

IBM 1403U buffer load 1 

IBM 3203 buffer load (IPL) 1 

IBM 3211 buffer load (IPL) 1 

IBM 3330 work file requirements 1 
I IBM 3800 support 1 

IBM 5203 buffer load (IPL) 1 
I IEBIMAGE utility 1 

initialize and restore programs 
bypass initialize disk 1 
initialize disk 1 
restore IBM tape to disk 1 

initialize data cell 24, 1 

initialize disk 24, 1 

initialize tape 24, 1 

installation verification procedure 
(see IVP) 

IOAPPN 22 

IOCS 

modules, compilers 1, 7 
modules, tape work files 7 

IOCS module sizes 
BTAM (BSC) 20 
BTAM (Start-stop) 20 
BTAM (transl. tables) 20 
compilers 7 
disk work files 7 

IODEV 1 

IOTAB macro 1 

IPL 1 

IPTADDR 3 

ISAM interface program 17 

ISMOD 7, 10 

IT parameter 1 

IVP 

assembly example 1 
creation of IVP stage II jobstream 
operating instructions 3 
optional SCP functions 3 
set-up requirements 3 
standard SCP functions 3 
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IVPGEN macro 
assembly 3 
execution 3 
parameters 3 



JA 1 

JALIOCS 1 

JIB 1 

job accounting interface 

job control 1 



K 



Kanji printer support ($$ABERRH 
transient) 1 



labels 1 

LFBUF 22 

librarian programs 1 

library block size 1 

library maintenance 1 

libraries on SYSRES file 1 

library sizes 1 

LINES 1 

linkage editing or deleting IBB 

components 1 
linkage editor 1 
LIST 1 

LIST (POWER/VS parameter) 2 
list system history (HISTLIST) 1, 24 
LISTX 1 
listings 1 
LOAD 1 

loading the SDL 1 
loading the SVA 1 
loading VSAM phases 1 
LOG 1 

logical units 1 
LPBUF 22 
LSERV 1 



M 



machine requirements 1 
macros for generating a 
supervisor 1 



macros, IBM 


-supplied 


ACB 17 




ALLOC 


1 


ALLOCR 


1 


ANUM 4 


,5 


ARUMGTYP 


21 


AS 20 




ASCTR 


20 


ASLIST 


20 


ASSGN 


1 


BDYBOX 


1 


BEGIN 


23 


BLDVRP 


17 


BPSFILES 


24 


BREAKOFF 


21 


BTBONLT 


20 


BTBTEIH 


20 


BTBTFIX 


20 


BTBTFREE 


20 


BTBTROD 


20 


BTBTRSCH 


20 


BTCEMODE 


20 


BTCKID 


20 


BTCONST 


20 


BTCSE 


20 


BTCTUPT 


20 


BTMOD 


20 


BTMODIH1 


20 


BTMODIH2 


20 


BTNCKID 


20 


BTOLTCMP 


20 


BTOLTIH 


20 


BTONLAP 


20 


BTONLOA 


20 


BTRD 20 


BTRLBF 


20 


BTRQBF 


20 


BTRWC 


20 


BTTRANS 


20 


BTWAIT 


20 


BUFARU 


21 


BUFFER 


21 


CCB 1 




CANCELM 


21 


CDMOD 


1 


CHANGE 


22 


CHECK 


1 


CHECKAEU 


21 


CHGNTRY 


20 


CHKPT 


1 


CHNGP 


21 


CHNGT 


21 


CHREQ 


21 


CLOSE 


1 


CLOSEHC 


21 


CLOSER 


1 


CLSDST 


22 


CNTRL 


1 


CONFG 


1 


CONFIGUR 


20 


CONTROL 


20 


COPYC 


21 


COPYP 


21 


COPYQ 


21 


COPYT 


21 


COUNTER 


21 


CRTAEX 


1 
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CRTAWT 1 
CRTGEN 1 
CRTGROUP 20 
CRTIO 1 
CRTSAV 1 
CTLTBL 21 
CTRLIST 20 
CTRSCHED 20 
DAMOD 7,8 
DAMODV 8 
DATESTMP 21 
DEULIST 20 
DEQB 17 
DISP 1 
DFR 14 
DFTMRLST 
DIMOD V 
DIRECT 21 
DISEN 11 
DISPGUID 20 
DLINT 14 
DLINTIN 
DLVRP 17 
DO 22 



20 

7 



14 



1 



DPD 

DRMOD 

DSPLY 

DSUB 

DTFBG 

DTFBT 

DTFCD 

DTFCN 

DTFDA 

DTFDI 

DTFDR 

DTFDU 

DTFEN 

DTFIS 

DTFMR 

DTFMT 

DTFOR 

DTFPH 

DTFPR 

DTFPT 

DTFQT 

DTFSD 

DTFSR 

DUMODFI 

DUMODFO 

DVCGEN 1 

EMUDI 6 

EM1403 6 

EM1442 6 

EM20CHK 

EM20CCNV 

EM20CPU 

EM20DI 6 

EM20END 

EM20MESS 

EM20PRHD 

EM20SYS 

EM20VBIF 

EM2152 

EM2203 

EM2311 

EM2400 

EM2501 



14 
13 
4, 5 
1 

20 
1 
1 
8 
1 

14 
9 
1 

10 
11 
12 
13 
1 
1 

1, 15 
21 
16 
1 



EM2520 6 
EM2560 6 
ENDFL 10 
ENDINTAB 22 
ENDQB 17 
ENDRCV 21 
ENDREADY 21 
ENDREQ 17 
ENDSEND 21 
EOA 21 
EOB 21 
EOBLC 21 
ERASE 17 
ERET 1 
ERRMSG 21 
ESETL 10 
EXCP 1 
EXECRPL 22 
EXLST 17 
FASTCOPD 24 
FASTCOPY 24 
FEOV 1 
FEOVD 1 
FOPT 1 
FREE 1 
GDUAS 20 
GDULIST 20 
GDUTRANS 20 
GENCB 17 
GET 1 
IFGACB 22 
IFGEXLST 22 
IFGRPL 22 
IHBRDWRA 22 
IISCR 6 
IISDC 6 
IISEDB 6 
IJLQDEQU 21 
IJLODSCT 1, 21 
IJLQTSVC 1, 21 
IKQACB 17 
IKQACBG 17 
IKQCB1 17 
IKQCB2 17 
IKQERMAC 17 
IKQEXLG 17 
IKQEXLST 17 
IKQRPL 17 
IKQRPLG 17 
INQUIRE 22 
INTAB 22 
INTERCPT 21 
INTERPRET 22 
IOINTER 1 
IOTAB 1 
ISMOD 1, 10 
ISTACB 22 
ISTACBG 22 
ISTAVT 1 
ISTBLDO 22 
ISTCBHTB 22 
ISTCB1 22 
ISTCB2 22 
ISTBIND 22 
ISTDNIB 22 
ISTDPOHD 22 
ISTDPROC 22 
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ISTDVCHR 22 
ISTEXLG 22 
ISTEXLST 22 
ISTRDWRA 22 
ISTEPL 22 
ISTRPLG 22 
ISTNSSBG 22 
IVPASLC 18 
IVPASLS 18 
IVPE20C 6 
IVPOLTC 19 
JDUMP 1 
LB RET 1 
LCBD 21 
LDO 22 
LERB 20 
LERPRT 20 
LINE 21 
LINETBL 21 
LIST 21 
LITE 11 
LOGCHAR 22 
LOGSEG 21 
LOPEN 20 
LPSTABT 21 
HAPCCMR 1 
MA PES PI B 1 
MAPLOWC 1 
HAPPUB2 1 
MCRAS 1 
MCR1 11 
MCR2 11 
MODCB 17 
MODE 21 
MODEEND 22 
MODEENT 22 
MODETAB 22 
MRMOD 11 
MSGTYPE 21 
MTMOD 7, 12 
MULDIV 4 
NETSOL 22 
NIB 22 
NOTE 1 
ONLTST 20 
OPCTL 2 1 
OPEN 1 
OPENR 1 
OPNDST 22 
OPTION 21 
ORDC 13 
ORJT 13 
ORMOD 13 
PABAMNUM 20 
PARMLIST 20 
PAUSE 21 
PIOCS 1 
PLINE 2 
POINT 17 
POINTR 1 
POINTS 1 
POINTW 1 
POLL 21 
POLLIMIT 21 
POSTARO 21 
POSTRCV 21 
POSTSEND 21 



POWER 1 
PREFIXD 21 
PRMOD 1, 7 
PROCESS 21 
PRTOV 1 
PTFPP 2^ 
PTFSCP 24 
PTMOD 15 
PUT 1 
PUTR 1 
QCBD 21 

| QSETPRT 1 
RCVCMD 22 
RCVHDR 21 
RCVITA2 21 
RCVSEG 21 
RCVZSC3 21 
RDLNE 13 
READ 1 
RECEIVE 22 
RELBUF 20 
RELEASE 1 
RELEASER 21 
RELSE 1 
REPEAT 21 
REQBUF 20 
REROUTE 21 
RESCN 13 
RESET 22 
RESETPL 20 
RESETSR 22 
RETRIEVE 21 
RMSRTAB 20 
BOUTE 21 
RUNMODE 1 
RPL 17 
SAMP327L 20 
SAMP327R 20 
SCANREQ 20 
SDMOD 7 
SDMODFI 16 
SDMODFO 16 
SDMODFU 16 
SDMODUI 16 
SDMODUO 16 
SDMODUU 16 
SDHODVI 16 
SDMODVO 16 
SDMODVU 16 
SDMODW 16 
SDRTAB 20 
SECTVAL 1 
SEND 1 
SENDCHD 22 
SENDHDR 21 
SENDSEG 21 
SEOV 1 
SEQIN 21 
SEQOUT 21 
SESSIONC 22 
SETDEV 14 
SETFL 10 
SETL 10 
SETLOGON 22 

| SETPRT 1 
SGAM 1 
SGCCWT 1 
SGDFCH 1 
SGDSK 1 
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SGEND 


1 




SGPMAIN 


1 




SGPOPT 


1 




SGPSUB 


1 




SGSCVRT 


1 




SGSVC 


1 




SGSVCX 


1 




SGTHAP 


1 




SHOWCAT 


17 




SHCWCB 


17 




SIMLOGC* 


I 22 




SKIP 21 




SMICR 


1 




SNDITA2 


21 




SNDZSC3 


21 




SOLICIT 


22 




SOURCE 


21 




STARTARU 


I 21 




STARTLN 


21 




STCBD 


21 




STDJC 


1 




STEND 


20 




STOPARO 


21 




STOPLN 


21 




SUPVR 


1 




SYSIO 


1 




TCLOSE 


17 




TERM 21 




TEBMTBL 


21 




TERMTBLI 


i 21 




TESTCB 


17 




TG ROUP 


20 




TIMESTME 


21 




TPEDIT 


20 




TRANS 


21 




TRANSLAI 


20 




TRLIST 


20 




TRNSLATI 


: 20 




TRSRCTW 


20 




TRSRCT3 


20 




TRSSCTW 


20 




TRSSCT3 


20 




TRUNC 


1 




TTIME.R 


1 




TWAIT 


20 




USSCMD 


22 




USSEND 


22 




USSMSG 


22 




USSPAiiM 


22 




USSTAB 


22 




VSTAB 


1 




WAITF 


1 




WOBD 21 




WORDTBL 


21 




WRITE 


1 




WRTBFR 


17 




WRU 21 






macros requrired and 


forced 1 


nain page pool size 


1 


■agnetic tape IOCS modules 7 


main page pool size 


1 


MAI NT 1 






maintain system history (PTFHIST) 24 


secondary storage 


requirements 1 


maintenance 


of libraries 1 


maps 1 






MCAR/CCH 


1 





1 



MCH 1 

MERGE function, use of 

MICR 1 

minimum machine requirements 1 

MNOTES during supervisor assembly 

MODE 1 

MODEL 1 

modulenumber suffix for CPU 1 

MRMOD (magnetic character reader 

module) 13 
MRSLCH 1 

MTMOD (magnetic tape module) 7,12 
multitasking 1 



N 



NPARTS 1 
NPBUF 22 
NRES 1 



o 



OBJMAINT 24 
OC parameter 1 
OLT 3 
OLTEP 19 r 1 
operational pack 1 
operational DOS/VS not available 1 
OPNAPPL 22 
OPNCLS 22 

optical reader sample problems 13 
organization of the system pack 1 
ORMOD (optical reader module) , size of 
13 



page data set dump (PDSDM) 


1 


page pool, main 1 




PAGEIN 1 




PAGPOOLS 22 




parameters 




ALLOC 1 




ALLOCR 1 




ASSGN 1 




CONFG 1 




DPD 1 




DTFBT table requirements 


formula 


DVCGEN 1 




FOPT 1 




IOTAB 1 




IVP 3 




PIOCS 1 




POWER 1 




SEND 1 
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STDJC 1 
SUPVE 1 
I TRC 7 

VSTAB 1 

partition save areas 1 

patch program (PDZAP) 1 

PC 1 

PCHADDB 3 

PCIL 1 

PD 1 

PDAID 1 

PDSDM 1 

PDZAP 1 

performance of FETCH and LOAD 1 

PFIX 1 

PHO 1 

physical and logical I/O assignments 1 

physical transient overlap (PTO) 1 

PIOCS 1 

PL/I, IOCS modules 7 

planning 

libraries (operational pack) 1 
supervisor 1 
system generation 1 

POWEE parameter in SUPVE 1 

POWEE/VS 

computing size of supervisor 1 
core image library blocks 1 
installation, documentation for 1, 2 
installation verification procedure 3 
macros 1 

POWEE parameter in SUPVE macro 1 
relocatable library blocks 1 
required and forced options with 

POWEE=YES 1 
source statement library blocks 1 
supervisor real storage requirements 1 
with BJE,SNA 1 

PPBUF 22 

prelinked utilities 24 

printer support, IBM 1403U, 3203, 3211, 
| 3800, and 5203 1 

PBINTLOG utility 1 

private libraries 1 

private second level directories 1 

PEMOD (printer module) 1,7 

problem determination, IBM-supplied list 
for DOS/VS 1 

procedures 1 

processing the distribution tape 1 

programs for system generation and 
maintainance, example of use 1 

PETY 1 

PET1 1 

PSEEV 1 

PSLD 1 

PSSWKA 22 

PTFHIST 24 

PTMOD (paper tape module) 15 

PTO (physical transient overlap) 1 

PWE 3 



| QSETPRT macro 1 
QTAM 21 
QTAM secondary storage requirements 



K 



EDE (reliability data extractor) 1 

BDT 22 

real address area 1 

real storage allocation 1 

recorder file 1 

reliability data extractor (RDE) 1 

EELLDE 1 

relocatable library 

assembler 18 

BTAM 20 

common librarian modules 1 

compiler IOCS modules 7 

COEGZ 1 

CSEBV 1 

DSEBV 1 

DUMPGEN 1 

emulator modules, library blocks 6 

EEEP 1 

ESEEV 1 

ESTVUT 1 

IBM 3211 printer support 1 

IPL 1 

job control 1 

linkage editor 1 

LSEEV 1 

MAINT 1 

MCAB/CCH 1 

module ID 1 

OLTEP 19 

PDAID 1 

PDSDM 1 

PSEEV 1 

QTAM 21 

EMS 1 

ESEEV 1 

SSEEV 1 

standard system dump 1 

translating system dump 1 

utilities 24 
relocating load support 1 
replacing identical entries 1 
required IOCS modules 7 
required macros 1 
EEBUN 3 
restore 24 

secondary storage requirements 1 
restore back-up tape to disk 1 
restore card to disk 24 

secondary storage requirements 1 
restore libraries 1 
restore system tape to disk 1 
restore tape to disk or data cell 24 

secondary storage requirements 1 
BETAIN 1 
BMS (EEBLOG) 1 
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RPGII IOCS modules 7 

RPL-oriented macro instruction storage 22 

EPS 

deletion of RPS support 1 

preloading modules in the SVA 1 
RSERV 1 
RSIZE 1 
rules 

ASSGN 1 

DVCGEN 1 

macros 1 

supervisor generation macros (basic) 1 
RWTAU 1 



SDAID 1 

SDL considerations 1 

SDMOD (sequential DASD modules) 7, 16 

SDMODW 7 

SDMODxx 7 

search order for phases 1 

second level directory 1 

SELCH 1 

selection of IBM-supplied supervisors 1 

SKND macro 1 

SET SDL 1 

SETIME 1 

SETPRT macro 1 

shared virtual area (SVA) 1 

size of compiler IOCS modules 7 

size of libraries 1 

size of main page pool 1 

size of supervisor 1 

SKSEP 1 

SLD 1 

SMSBUF 22 

SNT 22 

source statement library 1 

source statement library macros 

BTAM 20 

components of 1 

QTAM 21 

supervisor generation 1,11 

system generation 1 
source statement library, IBM-supplied 1 
SP 1 
SPARM 1 
SPBUF 22 
SRTADD 22 
SSERV 1 
SSLNS 1 
SSS 23 

standalone dump, high-speed 1 
standard label option 1 
standard system dump 1 

status information on system libraries 1 
STDJC 1 
storage requirements for DOS/VS 

programs 1 
STXIT 1 

subsystem support services 23 
suffix for CPU model specification 1 
supervisor selection 1 



supervisors shipped by IBM 1 

SUPVR macro 1 

SVA 1 

switchable channels 1 

SYM 1 

symbolic device name assignment 1 

symbolic programmer units, maximum 1 

SYNCH 1 

synchronous exit 1 

SYSALOAD 22 

SYSDEF 22 

SYSFIL 1 

SYSRES file 1 

system configuration 1 

system directory and library track 

capacities 1 
system directory list (SDL) 1 
system distribution 

disk users 1 

tape users 1 
system generation and maintenance 

procedure 1 
system I/O modules MTMOD 7 
system libraries 

directory capacities 1 

track capacities 1 
system utility program 1, 24 



table requirements 

DTFCD 1 

DTFCN 1 

DTFDA 11 

DTFDI 1 

DTFDU 9 

DTFIS 10 

DTFMR 11 

DTFMT 12 

DTFOR 13 

DTFPH 1 

DTFPR 1 

DTFPT 15 

DTFSD 16 

DTFSR 1 

DDMODFI 9 

DUMODFO 9 
TAPE 1 
tape ERP 1 

tape to data cell 1, 24 
tape to disk 1, 24 
tape to workfiles 

assembler 18 

modules 7 
task timer support (TTIWE) 1 
TEB 1 
TEBV 1 

teleprocessing (see BTAM, QTAM, or VTAM) 
time-of-day (TOD) clock support 1 
TOD 1 

TOLTEP (see VTAM) 1 
TP 1 
track capacity of system library 1 
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$$BENDFF 
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$$BENDFL 
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transients, required 1 
translating system dump 1 
| TRC parameter support 7 



TRKHLD 

TSWTCH 

TTIME 

TTIMEE 

TYPE 
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UNIT 
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USERID 
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utilities. 


prelinked 
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utilities, 


system 1, 
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UTS component 24 



values for communication line group 

VERIFY (IVP option) 3 

VFBUF 22 

virtual address area 1 

virtual partition save areas 1 

virtual storage access method (VSAH) 

virtual teleprocessing access method 

(VTAM) 22 
VOLID 1 

volume serial number 1 
VPBOF 22 
VSAM 1, 17 
VSAMEPS procedure 17 
VSAMSVA procedure 17 
VSIZE parameter 1 
VSTAB macro 1 
VTAM 1, 22 

considerations for linking 22 
VTOC display 1 



W 



WAITM 1 

warning diagnostics 18 
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Fold 



Fold 



NO POSTAGE 

NECESSARY 

IF MAILED 

IN THE 

UNITED STATES 



BUSINESS REPLY MAIL 

FIRST CLASS PERMIT NO. 40 ARMONK, N.Y. 



POSTAGE WILL BE PAID BY ADDRESSEE: 

IBM Corporation 

1 1 33 Westchester Avenue 

White Plains, N.Y. 10604 




Attention: Department 8 1 3 BP 



O 
O 
to 

< 

CO 

to 

< 

ct> 

3 

& 

n 

re 



Fold 



Fold 



3 

c 

CO 
> 

o 

CO 

CO 

en 
to 

-J 



